OS/32 
ASYNCHRONOUS 
COMMUNICATIONS 


Reference Manual 


48-047 FOO RO1 


Concurrent imum 
Computer Corporation 


The information in this document is subject to change without 
notice and should not be construed as a commitment by 
Concurrent Computer Corporation. Concurrent Computer 
Corporation assumes no responsibility for any errors that may 
appear in this document. 


The software described in this document is furnished under a 
license, and it can be used or copied only in a manner 
permitted by that license. Any copy of the described software 
must include any copyright notice, trademarks, or other 
legends or credits of Concurrent Computer Corporation 
and/or its suppliers. Title to and ownership of the described 
software and any copies thereof shall remain in Concurrent 
Computer Corporation and/or its suppliers. 


The licensed program described herein may contain certain 
encryptions or other devices which may prevent or detect 
unauthorized use of the Licensed Software. Temporary use 
permitted by the terms of the License Agreement may require 
assistance from Concurrent Computer Corporation. 


Concurrent Computer Corporation assumes no responsibility 
for the use or reliability of the software on equipment that i is 
not supplied by Concurrent Computer Corporation. 


© 1981, 1986 Concurrent Computer Corporation — All Rights Reserved 


Concurrent Computer Corporation, 2 Crescent Place 


Oceanport, New Jersey 07757 


Printed in the United States of America 


PREFACE 


CHAPTERS 


TABLE OF CONTENTS 


1 GENERAL INFORMATION 


1.1 


2 HARDWARE AND SOFTWARE CONFIGURATION PROCEDURES 


ss 6© @# © @ @ 
OO & WD Ee 


NNN NNNNNN HEHEHE HE 
CNH UPWNE 


NOD bd PON NN NH DN NOD DN NNN 


3.1 
3.2 
3.3 
3.4 
3.5 


INTRODUCTION 


HARDWARE 

Data Set Adapters 
Strapping Options 
Terminals 

Modems 

Cables 

DMA I/O Subsystem (DIOS) 


SOFTWARE 

Conversational VDU/TTY 

Model 1200 Editing VDU 

Models 1250/1251 Point-to-Point VDU 
Models 1250/1251 Multidrop VDU 
Supervisor Call 15 (SVC 15) Only 
Asynchronous Device 

Sigma 10 Terminal 

Remote Line Printer 

Module Specification 


ASYNCHRONOUS LINE DRIVER 


INTRODUCTION 

ASYNCHRONOUS LINE DRIVER AND SVC 15 
COMMANDS SUPPORTED 

SPECIAL CHARACTER PROCESSING 


DEFAULT VALUES 


48-047 FOO RO1 


vii 


Bh NON ND NO NON NN NH Nh 
! 
i Co ~] ~1 oy OT U1 Wo WE 


CHAPTERS (Continued) 


3.6 BUFFERS AND TRAPS 3-18 
3.6.1 Buffer Types 3-20 
3.6.2 Direct Buffers (Data Code xX'00') 3-20 
3.6.3 Indirect Buffers (Data Code X'04') 3-21 
3.6.4 Chained Buffers (Data Code X'08') 3-22 
3.6.5 Queued Buffers (Data Code X'0A') 3-24 
3.6.6 Traps 3-27 
S57 HOW TO USE THE ASYNCHRONOUS LINE DRIVER 3-29 


4 TELETYPE (TTY) VIDEO DISPLAY UNIT (VDU) TERMINAL MANAGER 


4.1 INTRODUCTION 4-1 

4.2 TERMINALS | 4-2 

4.3 SUPPORTED ATTRIBUTES 4-3 

4.4 SUPPORTED FUNCTIONS 4-3 

4.5 THE PERKIN-ELMER CAROUSEL 300 TERMINAL 4-4 

4.5.1 System Characteristics 4-10 
4.5.1.1 Character Structure 4-10 
4.5.1.2 Modem Connection 4-10 
4.6 PERKIN-ELMER MODEL 1100 VDU 4-11 
4.6.1 Operational Characteristics 4-11 
4.6.2 Controls 4-12 
4.6.3 Options (All Factory Installed) 4-13 
4.6.4 Principles of Operation 4-14 
4.6.5 Local Control Keys 4-14 
4.6.6 Single-Character ASCII Functions 4-15 
4.6.7 Multicode Sequences 4-17 
4.7 ENCODED ERROR MESSAGES 4-19 


5 MODELS 1200/1250/1251 EDITING VIDEO DISPLAY UNIT (VDU) 
TERMINAL MANAGERS 


5.1 INTRODUCTION 5-1 
552 FUNCTIONAL DESCRIPTION 5-1 
Se2el Device Assignment 5-1 
5.2.1.1 GENERATE Command 5-2 
5.2.1.2 GENERATE Macro 5-2 
5.2.1.3 XFMPCB Macro 5-4 
5.2.1.4 ELIMINATE Command 5-5 
5.2.1.5 ELIMINATE Macro 5-5 
5aleZ SVC 1 Interface 5-6 
5.2.3 SVC 1 Extended Options 5-6 


ii 48-047 FOO ROL 


CHAPTERS (Continued) 


Ulu Om OI Oo 1 OF OFT 01 OT U1 olor OO O71 uo Or or on moi 1S] 


uw S) 
e 2 e e 
= co m > > WWW WWW WWW WwW WW WWW WWWW W W W io) 


ui 
ul 


153) uo 
° ° 
~l ro) 


5.8 


eeeee ee #f @ e 
ee eee. 
Ol ®&® WD eH 


© & Pf P SW WW W WH WW WWW NOM DN NH Ne 


ee ee @ © ee #@ @ @ 
m WN woon~] va WN m W Ne 


e es a s 
Nh Nn NON a 
e 2 e 
Ww N j=! 


USING THE MODELS 1200/1250/1251 vbU 
TERMINAL MANAGERS 

Models 1250/1251 Terminal Congiguration 
Terminal Features and Special Character 
Format 

Multicode Sequence 

Attribute Characters 

Line Drawing Characters 

Status and Option Bytes 

Function Keys and Attention Identifier 
(AID) Characters 

Modes of Operation 

Conversational Mode 

Image Mode 

Editing Mode 

Concept of Request-to-Send (RQS) and 
Immediate 

Types of Data Read Formats 

Types of Data Write Formats 

Cursor Addressing and Random Addressing 
Horizontal Tabulation 

Printer Options 

Sysgen and Environment 

Special Parity Requirement 

Extended Device Code Specification 
Default Extended Functions/Options 
Terminal Switch and Strap Settings 


INTERNAL TERMINAL MANAGER DESIGN 
Relationship to Operating System and 
Asynchronous Line Driver 

Internal Structure 

Initialization and Function Code 
Interpretation 

Preparation for I/O, Control, and Enter 
Svc 15 


Final Clean Up 

TYPICAL PROBLEM CHECKLIST 
MULTIDROP FEATURE 

LIGHT PEN 


ENCODED ERROR MESSAGES 


48-047 FOO ROI 


5-14 
5-14 


5-14 
5-15 
5-16 
5-17 
5-18 


5-20 
oe 21 
5-21 
o> 22 
2-22 


5-22 
o723 
5-30 
5-31 
5-31 
5-32 
5-32 
5733 
5-33 
5-34 
5-36 


5-36 


5-36 
5-40 


5-41 


5-42 
5-42 


5-42 
5-43 
5-43 
5-43 


iii 


APPENDIXES 


A DRIVER COMMAND WORD FORMAT A-1 


B STANDARD ASCII CODE B-1 

FIGURES 

2-1 Functional Relationships of Device Dependent and 
Device Independent Asynchronous Support = 


2-2 Spectron MIS-3400 Strapping for the Model 1250 
Video Display Unit (VDU) Multidrop Configuration 


Supervisor Call 15 (SVC 15) Parameter Block 
Function Code Format 
Supervisor Call 15 (SvC 15) Status Halfword 
Driver Command Word Format 
Adapter Command 1 (CMD1) 
Adapter Command 2 (CMD2) 
Supervisor Call 15 (SVC 15) Data Field 
Direct Buffer 
Indirect Buffer 

0 Chained/Queued Buffer Format 

1 Chained/Queued Buffer Link Word Flag Byte 

2 Conceptual Circular List and Format 

3 Task Trap Format 


mo ooo 1 on OF On OF OF O1 oe WWWW WW WWW WWW W 
Me RHR OONKNU PWN FE Ne RMR RHR OOAINU PWN Ee 


O1O1 OF O1 & WW WW WW WWW WWW WW N N 
I 
ee OO Fr NO ND M NM DOD MRR Om DN Dd ~ NO 
CON WW NE O UID 


Extended Device Code Halfword 
Character Structure 


Extended Options Fullword Format 


- Attribute Characters -17 
- Status Byte Format. ~19 
- Option Byte 1 Format -19 
- Option Byte 2 Format 5-20 
- Read All with Format Screen 5-24 
- Read All with Attribute Character Truncated 5-25 
- Read Unprotected Format (Model 1200 VDU) 5-26 
- Read Unprotected Format (Models 1250/1251 VDUs) 5-27 
-10 Read Modified Format (Model 1200 VDU) 5-29 
-11 Read Modified Format (Models 1250/1251 VDUs) 5-30 
-12 User Buffer Format. Table for Horizontal Tabs 5-31 
-13 OS/32 Basic Data Communications Extended 

Device Code Halfword 5-33 


iv 48-047 FOO ROL 


FIGURES (Continued) 


b&b & hb b a ers NON ND 
11 ee or oe ! 
Ul & WN Fe WN) &m W NF 


eae oe 
SIS Ob WN EF 


INDEX 


Models 1200/1250/1251 Terminal Managers/ 
Asynchronous Line Drivers Relationship 
(Point-to-Point) 

Device Control Block (DCB) Fields for Models 
1200 and 1250/1251 VDUs 

Kernel Terminal Manager Flow Diagram 


ASYNCHRONOUS ADAPTERS 

EXTENDED DEVICE CODES 

COMMON TERMINAL LOGICAL RECORD LENGTHS 
SPECIAL ASYNCHRONOUS CHARACTERS 


ENCODED ERRORS AND DEFINITIONS 
DRIVER COMMAND OPTIONS 
SUPERVISOR CALL 15 (SVC 15) TRAPS 


ADDRESSABLE HORIZONTAL TABULATION CODING CHART 
ADDRESSABLE VERTICAL TABULATION CODING CHART 
FORM LENGTH CODING CHART 

CURSOR ADDRESSING . 

ENCODED ERRORS AND DEFINITIONS FOR TELETYPE (TTY) 
TERMINAL MANAGER 


SVC 1 FUNCTION/FUNCTION MODIFIER OPTIONS 
FUNCTION/FUNCTION MODIFIER COMBINATIONS 
MULTICODE SEQUENCES 

LINE DRAWING CHARACTERS 

ATTENTION IDENTIFIER (AID) CHARACTERS 
DEFAULT EXTENDED OPTIONS 

ENCODED ERRORS AND DEFINITIONS FOR MODELS 
1200/1250/1251 TERMINAL MANAGERS 


48-047 FOO RO1 


i I 
HH OW 
me 


I 
moO NTO NO UI 


[oe] 


i 
N) 
© \o 


WOM -» PEEP WWW ND ND 
! | 
bt 
co 


! 
NO 
© 


5-35 


Ind-1 


PREFACE 


This manual is intended for users whose installations are 
configured with the following asynchronous devices: 


@ Model 550 video display unit (VDU) 
@ Model 1100 VDU 


@ Carousel 300 

@ Model 1200 VDU 

e Models 1250/1251 vVbDUs 
e Sigma 10 terminal 

@e Remote line printer 


e Graphic display terminals 


The reader should be familiar with the OS/32 basic data 
communications subsystem. 


Chapter 1 defines asynchronous device support on a device 
independent level and a device dependent level. Chapter 2 
discusses the hardware, software, and configuration procedures 
required for the terminal managers and the asynchronous line 
driver. Chapter 3 describes the asynchronous line driver that 
interfaces the communications adapter with the user program and 
allows the use of protocols not supported by a terminal manager, 
Special buffering techniques, and data or command chaining. 
Chapter 4 describes the Teletype (TTY)/VDU terminal manager. 
Chapter 5 describes the features of the Models 1200/1250/1251 
Editing VDU Terminal Managers, including multidrop, light pen, 
and downline load support. 


This manual replaces S29-542 and provides device statements for 
the Sigma 10, Models 1250/1251 VDUs and the Perkin-Elmer remote 
line printer. It also adds information on the support of the 
current loop communications multiplexor (CLCM) and outlines the 
additional features supported by the terminal manager for use on 
the Models 1250/1251 VDUs. This manual pertains to the OS/32 6.0 
software release and higher. 
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The following publications can be used in conjunction with this 


manual: 


PUBLICATION 
MANUAL TITLE NUMBER 

M47-102 Programmable Asynchronous Single Line 

Adapter (PASLA) Maintenance Manual 29-301 

Perkin-Elmer Carousel 300 Programming Manual 29-462 

OS/32 Basic Data Communications Reference 

Manual 29-541 

Model 1200 Terminal Installation and 

Programming Manual 29-631 

Current Loop Communications Multiplexor 

Programming Manual 29-732 

M47-100/101 Programmable Asynchronous Line 

System (PALS) Maintenance Manual 29-276 

OS/32 System Macro Library Reference Manual 48-006 

Models 1250/1251 Visual Display Units (VDU) 

Terminal Configuration User Guide 48-022 

OS/32 System Generation (Sysgen) Reference 

Manual 48-037 

OS/32 Supervisor Call (SVC) Reference Manual 48-038 

OS/32 Application Level Programmer Reference 

Manual 48-039 

OS/32 System Level Programmer Reference Manual 48-040 

32-Bit Systems User Documentation Summary 50-003 

Models 1250/1251 VDUs User's Manual 59-300-0048 
For further information on the contents of all Perkin-Elmer 
32-bit Manuals, see the 32-Bit Systems User Documentation 
summary. 
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CHAPTER 1 
GENERAL INFORMATION 


1.1 INTRODUCTION 


This reference manual describes asynchronous support of remote 
data terminals Or computers via the OS/32 communications 
subsystem. The communications subsystem supports asynchronous 
devices on two levels: 


@ Device independent (or device transparent) level 


@ Device dependent (or device sensitive) level 


Device independent level of access is achieved by issuing 


Supervisor call 1 (SVC _ 1) to a terminal manager. This can be 
done by a user READ or WRITE macro. A terminal manager contains 


the logic to initiate, maintain, and terminate transmissions to 
a logical device called a terminal. The terminal manager calls 
the asynchronous line driver, which controls the data adapter 
interface and transfers data over a communication line. Two 
terminal managers are described in this manual: 


® Teletype (TTY)/Video Display Unit (VDU) Terminal Manager 
@ Perkin-Elmer Models 1200/1250/1251 Editing VDU Terminal 


Managers 


Device dependent level of access is achieved by a communication 
user task (u-task) directly accessing the same asynchronous line 
driver via SVC 15. This line driver is described in Chapter 3 of 
this manual. 
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CHAPTER 2 
HARDWARE AND SOFTWARE CONFIGURATION PROCEDURES 


2-1 HARDWARE 


This section presents the asynchronous devices supported by the 
data communications subsystem. Figure 274 shows the 
interrelationships of the software and hardware associated with 
asynchronous communications. 
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2874 
SVC 1 svc 15 


Sateen nenatanataie Assembly sslantetenteniestentanentetententen Assembly language 
Device | language | Device | task 
| independent | FORTRAN | dependent | 9 --wsercrc------ 
{ task | COBOL | task | Or 
Sania Centesteenteaten | tenientetestety tebetesteteten special 
{ | RTL 
| svc 1 | | svc 15 | 
| executor | | executor | 
| Asynchronous | 


| terminal | 
| manager | 


| Asynchronous | | Support | 
| line bee module | 


| driver | | subroutines | 


Asynchronous | 
2-line MUX RS232C or | 
8-line MUX current loop| 


| 
| 
PASLA | Null | 
| | 
| | 
CLCM ~——_-—____—______———-»| terminal | 
| 
| 
| 
| 


| WE | 
{ 103 modem 


| WE 


| Asynchronous | 
| RS232C or | 
| current loop| 
| terminal | 


Figure 2-1 Functional Relationships of Device Dependent 
and Device Independent Asynchronous Support 
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2.1.1 Data Set Adapters 


As shown in Figure 2-1, the first hardware device to 


respond to 


an SVC 1 or SVC 15 coming through the asynchronous line driver is 


one of the five data set adapters listed in Table 2-1. 


TABLE 2-1 ASYNCHRONOUS ADAPTERS 


(2-Line MUX) 


| | PRODUCT 
| DEVICE | NUMBER 
| Programmable asynchronous line system | M47-102 
| (PALS) | 

| | 

| Programmable asynchronous single line | M47-100 
| adapter (PASLA) | 

| | 

| Two-line communications multiplexor | M47-104 
| | 

| | 


Eight-line communications multiplexor M47-105 
(8-Line MUX) 


| | 
| Current loop communications multi- | M47-110 
| plexor (CLCM) | 


DEVICE | 
CODE | 


NOTE 
PALS cannot be used with the Perkin-Elmer 
3200 Series processors, only with the 
Model 7/32 or 8/32 processor. 
2.1.2 Strapping Options 


Strapping options must be taken into account’ when 


performing 


system generation (sysgen). The PASLA and the PALS provide the 


following strapping options: 


e Baud Rates: 


- PASLA: 75 to 9600 


- PALS: 75, 110, 134.49, 150, 300, 600, 1200 and 1800 


(others available on special request) 
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PASLA has two clocks, and PALS has four clocks. The user 
selects the rate at which data is transmitted to and from the 
terminal. For details on how to strap baud rates to _ the 
clocks, see the Programmable Asynchronous Line System (PALS) 
Maintenance Manual or the Programmable Asynchronous’ Single 
Line Adapter (PASLA) Maintenance Manual. 


@e Data set ready These can be strapped so_ that they 
appear in a constant ready state to the 
@e Clear-to-send CPU. When connecting a terminal to a 
modem via a null modem cable,’ these 
e Carrier options are normally disabled. 


e Full duplex (4-Wire). This allows the user to transmit 


messages in two directions simultaneously. Full-duplex 
transmission also allows echoplex operation in dumb terminals. 


Most local applications (cable connected) and all Western 
Electric 103 modem applications should be strapped 4-wire, and 
the sysgen statement for that device must indicate 4-wire. 


e Half duplex (2-Wire). This is used for alternate send and 
receive mode when echoplexing is not required. 


e Hardware address. This provides the program with the number 
of the communications line leading to a given hardware device. 
When strapped 4-wire, the sysgen statement for that device 
must specify the even hardware address. 


The 2-line and 8-line multiplexors provide the following 
strapping options: 


e Baud rates: 50 to 19,200 baud with these strap/clock 
combinations: 


SETI SET2 SET3 SET4 


CLOCK A 50 75 150 300 
CLOCK B 110 134.5 600 1200 
CLOCK C 1800 2000 4800 7200 
CLOCK D 2400 3600 9600 19200 


e The strapping options for data-set-ready, clear-to-send, 
carrier, full duplex, half duplex, hardware address, and ring 
are similar to PALS/PASLA. 


The CLCM board is normally strapped for 150/600/4,800/9,600 baud 
rate operation. By modifying the board from the standard factory 
design, five alternative baud groupings are possible. 
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Each of the eight lines of the CLCM can be operated at one of 16 
possible baud rates as follows: 50, 75, 110, 134.5, 150, 300, 
600, 1,200, 1,800, 2,000, 2,400, 3,600, 4,800, 7,200, 9,600, or 
19,200. A 4-bit code selects the baud rate for each line. Two 
bits of the code are programmable, allowing the selection of 1 of 
4 baud rates. The remaining two bits are switch selectable, 
providing four subsets of 4 baud rates each. 


2.1.3 Terminals 


RS232C or CLCM compatible devices supported are: 


TERMINAL DEVICE CODE 

Nonediting video display unit (VDU) 

(Models 550 and 1100) 147 
Teletype (TTY) Keyboard/Printer 

(Carosuel 300) 147 
Model 1200 Editing VDU 156 
Models 1250/1251 Point-to-Point 157 

Or Multidrop 

Graphic Display Terminals 158 
Sigma 10 Terminal 146 
Remote Line Printer 145 


2.1.4 Modems 
The only modems that should be used to interface the asynchronous 
devices to the software described in this manual are: 
Western Electric 103A, 103J, 113D, or equivalent modem 
(4-wire switched or leased) 
Null Modem, M46-106 (cable for direct connection) 


The following options should be selected when a 103J or 113D is 
used: 


@e Receive space disconnect NO 

e Send space disconnect NO 

e Loss-of-carrier disconnect NO 

@e cCC indication EARLY 

e CB and CF indications SEPARATE 


e CC indication on analog loop ON 
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e Failsafe state of CN circuit OFF 
e Automatic answer YES 


e Common grounds YES 


2.1.5 Cables 


A cable is supplied with the PASLA to connect it to the 
convenience panel of a Perkin-Elmer system cabinet. This cable 
is Perkin-Elmer Part Number 17-197. 


An optional null modem cable, Perkin-Elmer Part Number 17-197, is 
used to connect the convenience panel with the PASLA 7-inch 
interface and the following video display units: 


@e Low-end VDU (115V/60Hz) 
e Low-end VDU (240V/50Hz) 


e Alphanumeric VDU 


The typical length of the null modem cable is 50 feet. It has 
some unusual characteristics; e.g., some wires loop back, which 
sometimes require that it be modified for terminals other’ than 
those cited previously. 


A 2-line MUX has one 17-463 ribbon cable connected between the 
connector at the edge of the board and the cable entry panel. An 
8-line MUX can have up to four 17-463 ribbon cables connected 
between the four connectors at the edge of the board and the 
cable entry panel. 


An optional cable, Perkin-Elmer Part Number 17-050F02R02 (Product 
Number M10-054), is used to connect one communications line from 
the I/O convenience panel to a moden. 


Up to two 17-522 ribbon cables can be used to connect the CLCM to 
the processor entry panel. To connect the processor entry panel 
to the current loop adapter, select from the list below one cable 
that meets the required length. 


PART NUMBER LENGTH 
17-535 FO1 30.48m (100') 
17-535 FO2 76.20m (250') 
17-535 FO3 152.40m (500') 
17-535 FO4 304.80m (1,000') 
17-535 FO5 762.00m (2,500') 
17-535 F06 1,524.00m (5,000') 
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When using the Models 1250/1251 Terminal Managers to support the 
Models 1250/1251 VvDUS ina multidrop environment, Perkin-Elmer 
recommends that the Spectron MIS-3400 modem splitter be used to 
connect the 1250 terminals to the software. Figure 2-2 
designates which segments of the MIS-3400 must be strapped to 
provide compatibility with the terminal manager. 
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Figure 2-2 Spectron MIS-3400 Strapping for Models 
1250/1251 Video Display Units (VDU) 
Multidrop Configuration 


2.1.6 DMA I/O Subsystem (DIOS) 


The Perkin-Elmer DMA I/O Subsystem can be used with an 
asynchronous”7 system. This provides a significant gain for 
processor bandwidth. For Models 1200 and 1250/1251 vDUs, DIOS 
microcode contains subroutines to process special read/write 
characters. 


2.2 SOFTWARE 
The recommended sysgen procedure for an OS/32 configured with the 


communications subsystem is found in the OS/32 System Generation 
(SYSGEN) Reference Manual. 
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The device statements for asynchronous devices are given on the 
following pages. They must be specified as presented; no default 
is provided for the extended basic data communications options. 


2.2.1 Conversational VDU/TTY 


The VDU/TTY sysgen device statement format is: 


1 dnem: adr,147,,Xxdcod,lrecl ,Xrdcl,Xwtcl,pdseql 


Where: 


dnem dnem is the device mnemonic. 


adr is the device address. 


dcod specifies the device code; 


147 is the device 


code for conversational TTY/VDU. 


Xxdcod specifies the basic data communications 
| extended device code. This value can be 

specified in either decimal or hexadecimal. 

If using hexadecimal, precede the numeric 


value with an xX. See 
description of options. 


Table 2-2 for a 


lrecl specifies terminal logical record length. 


Normally this length 


is the number of 


characters that can be printed on each line. 
See Table 2-3 for a list of common terminal 


logical record lengths. 


Xrdcl specifies activated read control characters. 
Changing this value permits the user to 
specify which special characters may be used 
to terminate a line, as a line delete, or as 
a backspace. This value may be specified in 
either Gecimal or hexadecimal. If using 
hexadecimal, precede the number with an xX. 
See Table 2-4 for a description of options. 


Xwtcl specifies activated write-control characters. 
Changing this value permits the user to halt 
write on certain special characters, activate 
the carousel buffer overload protocol, or use 
an ESC character Similar to a break. 
Normally, no halt characters are activated. 
Specify the carousel buffer overload protocol 


whenever a Carousel 300 


series terminal is 


used. This value can be specified in either 


decimal or hexadecimal. 
description of options. 


See Table 2-4 for a 
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pdseql 


specifies the length of the pad sequence 
appended to all conversational reads and 
writes. This value can range from 0 to 15. 
Normally, it should be set to 2 (LF, CR) for 
a VDU, or 3 (LF, CR, CR) for a “TTY. For 
certain TTY devices, specify a larger pad 
count to allow adequate time for carriage 
return. 


TABLE 2-2 EXTENDED DEVICE CODES 


\ 
an OE C8 GY Om Om Gm EY ay OE Ge GST Oe Sm om ee Ole GE Gee GE GE om SE Gin CET Gm GF Om Gms Ot CFE Ben OS een rt OR GEE OO Om Gee CY oe OT Gey Gee eee oe OE om Om aw ow Om om 


HEX MASK | | 


BIT | 
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automatic connect if an SVCl 
read/write request is issued 


(DECIMAL VALUE) | MEANING | 
8000 | Master/slave bit (processor- | 
| to-processor link only) | 
| | 
8000 (32768) | Indicates that this end of | 
| processor-to-processor link | 
| ais master | 

0000 (0) Indicates that this end of 
| processor-to-processor link | 
| is slave | 
| | 
7000 | Reserved - must be zero | 
| | 
0Cc00 | Line configuration bits | 
| | 
0800 (2048) |! Automatic dial-in or manual | 
| dial-out | 
| : | 
0400 (1024) | Leased line | 
| | 
0000 (0) | Directly connected (null | 
| modem cable) | 
| | 
0300 | Line protocol bits | 
| | 
0300 (768) | Half duplex 2-wire | 
| | 
0200 (512) | Simplex write * | 
| 
0100 (256) | Simplex read * | 
| | 
0000 (0) | Half duplex 4-wire * | 
| | 
0080 | Explicit Connect Request bit | 
| | 
0000 | Indicates system will do an | 
| | 
| | 


* 


TABLE 2-2 EXTENDED DEVICE CODES (Continued) 


me Gat Gas OE ame CET Gen See SEE ame ee Oe oe Oe Oe ee OF ee = FT ow ow oF a OS om oe 


| HEX MASK 
BIT | (DECIMAL VALUE) | 


ee ee OS ee ee ee a ee ee ee ee ee ee ee ee Oe et ee ae oe es ee ee 
ee ee ee ee ee 


0080 


is) 


10-11 
0030 (48) 
0020 (32) 
0010 (16) 
0000 (0) 
12-15 


Requires adapter-strapped 


MEANING 
to a line that is not con- 
nected. Status returned is 
8225. 


If the line is disconnected 
during read/write request, 
AOXX status is returned. 
Next read/write issued will 
cause system to automatic- 
ally connect the line. 


Indicates system will return 
error AQ18 if SVCl read/ 
write request is issued toa 
line that is not connected. 
Reserved -—- must be zero 
Clock bits (PALS/PASLA only) 
Clock D 

Clock C 

Clock B 

Clock A 
Default option index for 
Models 1200 and 1250/1251. 
Must be zero for all other 


devices. 


full duplex 
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TABLE 2-3 COMMON TERMINAL LOGICAL 
RECORD LENGTHS 


| | LOGICAL 

| TERMINAL | RECORD LENGTH | 
[Model 50/5508 1 80 
| Model 1100 vbuU | 80 

| Model 1200 vbU | 80 

| Models 1250/1251 ! 80 

| vDUs | 

| Carousel | 128 

| M33. TTY | 72 

! M35 TTY ! 80 

| Sigma 10 terminal : 73 

| Remote line | 132 


printer 


TABLE 2-4 SPECIAL 
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MASK 


Se ee ee ee ewe we we ee re ee re re ee ee me ee re ee wre ew wee wee es wee re ore ree ee ew we ewe ww we ee ee ee 
I ee ee er ee ee ee ee ee 


Termina- 
tion 
charac- 
ters 
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CHARACTER | ASCII| 
CR X'OD' | 
ETX eat 

| 
EOT X'04' 


User-defined 


Any enabled 
line delete 
character 


RO1 


Carriage Return 


End of Text 
(CTRL C) 


End of Transmis-— 
sion (CTRL D) 


Terminate Read/ 
Write 


Terminate Read- 
on-Line Delete 


X'8000' 
X'4000' 


X'2000' 


X'0200' 


X'0100' 


X'8000' 
X'4000' 


X'2000' 


X'0200' 


TABLE 2-4 SPECIAL ASYNCHRONOUS CHARACTERS (Continued) 
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| | | | READ | WRITE 
TYPE | CHARACTER |} ASCII | MEANING | MASK | MASK 
Backspace| BS | X'O08'| Backspace | x'0080' | 
| | : (CTRL H) : : 
| | 
| <-- | X'5SF'| Back Arrow or | x'0040' | 
| | | Underscore | 
| : : (Shift 0) | | 
| User Defined| --- | | X'0010' | 
Line | # | 23 | Number sign | x'0108' | 
Delete | | | | | 
| | | | | 
| User Defined | | 1 x¥'0102' | 
| | | | | 
| NAK or { 15 | NAK (CTRL-U) |} x'0101' | 
| CAN | 18 | CANCEL (CTRL-X) | X¥'0101' | 
Control | DCl, DC2 | 11,12] Carousel/Printer | | x'0400! 
| | | (START) | | 
| DC3, DC4 | 13,14] Buffer Controls | | x'0400! 
| | | (STOP) | | | 
Break | BREAK | | Break fulfills | | x'0O01' 
| | prepare : 7 
| ESC | X'1B'| Allow Escape to | | x'0008' 
| | | | 


| break write 


2.2.2 Model 1200 Editing VDU 
The Model 1200 Editing VDU sysgen device statement format is: 
1 dnem: adr,156,,Xxdcod,lrecl,,,pdseql 

See Section 2.2.1 for descriptions of the variables in this 
device statement. 
156 specifies device code 156, Model 1200 Editing VDU. 

xdcod specifies the same communications extended 

device code as a conversational VDU. See 


Table 5-2 for additional Model 1200 VDU 
options. 
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2.2.3 Models 1250/1251 Point-to-Point VDUs 
The Models 1250/1251 Point-to-Point VDUS sysgen device statement 
format is: 

1 dnem: adr,157,,Xxdcod,lrecl,,,dseql 
See Section 2.2.1 for descriptions of the variables in this 
device statement. 
157 specifies device code 157, Models 1250/1251 Point-to-Point 
VDUs. . 


Xxdcod specifies the same communications extended 
device code as a conversational VDU. See 
Table 5-2 for additional Models 1250/1251 VbDU 
options. 
2.2.4 Models 1250/1251 Multidrop VDU 
The Models 1250/1251 Multidrop VDU sysgen device statement format 
is: 7 
1 dnem: adr,158,,Xxdcod,lrecl,,,pdseql 
See Section 2.2.1 for descriptions of the variables in this 
device statement. 
158 specifies device code 158, Models 1250/1251 Editing VDUs. 
Xxdcod specifies the same communications extended 
device code as a conversational VDU. See 
Table 5-2 for additional Models 1250/1251 vDU 
options. 
2.2.5 Supervisor Call 15 (SVC 15) Only Asynchronous Device 
The SVC 15 only asynchronous device sysgen device statement 
format is: 
1 dnem: adr,144,,Xxdcod, ,Xrdcl,Xwtcl 
See Section 2.2.1 for descriptions of the variables in this 
device statement. 


144 specifies device code 144, SVC 15 only asynchronous device. 
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2.2.6 Sigma 10 Terminal 


The Sigma 10 Terminal sysgen device statement format is: 
1 dnem: adr,146,,Xxdcod,lrecl,Xrdcl,Xwtcl,pdseql 


See Section 2.2.1 for descriptions of the variables in this 
device statement. 146 specifies device code 146, Sigma 10 
Terminal. 
NOTE 
For local operation of the Sigma 10 
Terminal use the following format: 


1 dnem: adr,146,,,73 


2.2./ Remote Line Printer - DCOD 145 


Format: 
1 dnem: adr,145,,Xxdcod,lrecl,Xrdcl,Xwtcl,pdseql 


See Section 2.2.1 for descriptions of the variables in this 
device statement. 145 specifies device code 145, Remote Line 
Printer. 
NOTE 
For local operation of the Remote Line 
Printer, use the following format: 


1 dnem: adr,145,,,132 


2.2.8 Module Specification 


An additional option is available for the module statements. 
This option can be used to request inclusion of a user-assembled 
communications subsystem module. Acceptable formats for the 
module statement now include: 


ITAM. Xxx 


where xxx iS a unique identifier. Currently supported options 
are ITAM.MOl, the standard communications module, and ITAM.U00 
for a user-assembled module. 
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CHAPTER 3 
ASYNCHRONOUS LINE DRIVER 


3.1 INTRODUCTION 


This chapter discusses the asynchronous line driver that allows 
users to: 


@ access terminals using protocols or codes not supported by a 
terminal manager, 


@ use special buffering techniques, and 


@e use data or command chaining to achieve a higher’ throughput 
rate. 


The reader should be familiar with the basic data communications 
concepts, particularly supervisor call 15 (SVC 15), described in 
the OS/32 Basic Communications Reference Manual. 


The asynchronous line driver provides an interface between the 
user program and the programmable asynchronous line system 
(PALS), programmable asynchronous single line adapter (PASLA), 
2-line communications multiplexor (2-line MUX) , 8-line 
communcations multiplexor (8-line MUX) , Or current loop 
communications multiplexor (CLCM) communications adapter which, 
in turn, support the terminals listed in Chapter 2. This line 
driver allows the user to specify the control sequences and data 
necessary to complete a transmission over a communications line. 


To transmit or receive data over a communications line with 
RS232C interface leads, the asynchronous line driver communicates 
with PALS, PASLA, 2-line MUX, or 8-line MUX. To transmit or 
receive data over a communications line with current loop 
interface leads, the asynchronous line driver communicates with 
CLCM. The driver does not have to be aware of what devices are 
downstream from these adapters. The terminal manager written to 
Support the driver, however, must be given the device attributes. 


3.2 ASYNCHRONOUS LINE DRIVER AND SVC 15 


The asynchronous line driver is an SVC 15 line driver; i.e., it 
can be accessed by a user SVC 15 or by the terminal manager. SVC 
15 access to the line driver provides greater control over 
adapters, devices, and formats than terminal manager access. A 
user task (u-task) makes an I/O call with the SVC 15 instruction 
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and parameter block. See the OS/32 Basic Data Communications 
Reference Manual for a detailed description of this parameter 
block. Figure 3-1 illustrates the SVC 15 parameter block 
structure. 
2876 
10(0) {1(1) |2(2) | 
| Function | lu | Status | 
| code | | | 
ei taite eee e enema eee oe ee eee ae ee eee ee l 
14(4) No. of 15(5) | 
| commands | A(DCW chain) | 
| executed | | 
[8(8 [10 (A) | 
| Length of last read | Length of last write | 
| | 
gn a ca ea aac an | 
[12 (Cc) [13 (D) | 
| Data code l1l_ | A(data area 1) | 
| | | 
ape ea oo ca a a a a al a | 
{16 (10) 117(11) | 
| Data code 2 A(data area 2) | 
[2a SSS a a ee Se Se Re Se ay ee ee | 
| | 
oe A 
; ad 


Figure 3-1 Supervisor Call 15 (SVC 15) Parameter Block 


The first byte in the parameter block is a function code provided 


by the u-task. This function 
applicable to the entire SVC 15. Figure 3-2 
options. 
2877 
Scheme eee Seem 4S $----- 
| | | | | Reserved 
Bits: 0 1 2 3 4 7 
Figure 3-2 Function Code Format 

3-2 


code specifies certain options 
illustrates 


these 
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Fields: 
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HALT 1/0 

An SVC 15 call with this bit set specifies 
that the u-task is requesting to halt an I/O 
Operation that is in progress. The program 
status word (PSW) condition code indicates the 
results of the halt I/O call as follows: 


cc=0 The halt I/O has been accepted and 
the original call can be considered 
to end with status indicating halt 
I/O. If an error occurred before 


the HALT I/O call, an error status 
Will be returned. If the original 


call specified termination traps, a 
trap is generated for the original 
parameter block when the halt goes 
to completion. 


cc=l] The halt I/O was not accepted 
because the driver was not 
performing any SVC 15 I/O to the 
logical unit (lu) specified for the 
task at the time of the call. The 
status field is not changed. I/0 
may have terminated normally just 
prior to the halt I/O call. 


COMMAND QUEUE ENTRY ENABLE 

This bit must be set, along with the 
corresponding bit in the driver command word 
(DCW) and the enable SVC 15 queue entry bit in 
the task status word (TSW), to allow a trap at 
the start of each DCW execution. 


BUFFER QUEUE ENTRY ENABLE 

This bit must be set, along with the 
corresponding bit in the DCW and the enable 
SVC 15 queue entry bit in the TSW, to allow a 
trap at the start of each buffer use 
associated with the DCW. 


TERMINATION QUEUE ENTRY ENABLE 

This bit must be set, along with the enable 
SVC 15 queue entry bit of the TSW, to allow a 
trap on normal or abnormal completion of the 
svc 15. A halt I/O call does not generate a 
trap; however, the call being halted does if 
it Originally specified termination queue 
entry enable. 


Reserved for future use. 


The second byte is the lu, also provided by the u-task. This 
byte specifies the device assigned for SVC 15 access. 


The next halfword is for the communications subsystem status 
returned from the driver to the u-task. Figure 3-3 shows the SVC 
15 status halfword. 


2878 
Status bits 


| | | | | | | | | Encoded | 
| | | | | | | | | | termination code | 


Figure 3-3 Supervisor Call 15 (SVC 15) Status Halfword 


STATUS BIT 
(HEX) MEANING DESCRIPTION 

0 (X'8000') Error Set for all error conditions and 
any termination code greater 
than 2. 

] (X'4000') Busy Driver is still busy with SVC 15 
call. Can be cancelled via halt 
I/O. 

2 (X'2000') Transfer not This bit is reset after the 

begun first character is received or 
sent. 

3 (X'1000') Timeovt Set for I/O timeout. 

4 (X'0800') Parity Set on detection of parity 
errors. If the encoded error is 
also parity, the driver 
terminated on the error. 

6 (X'0200') Back space Attempt to back space over 

error buffer limits using chained or 
queued buffers. 

8 (X'0080') Line delete Line delete character detected 


detect in input data. 


Table 3-1 lists the termination codes resulting from a terminated 
SVC 15. These codes occur independently of the status bits 
Gefined for Figure 3-3. 
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TABLE 3-1 ENCODED ERRORS AND DEFINITIONS 


| (HEX) | 


No errors 
Line delete 


Break on write 
Break on read 

Data check 

Framing error 
Reverse channel 
Loss of carrier 
CL2S error 

Data set not ready 
Device unavailable 
Overflow 

Ring 


Buffer overrun-l 


NCE overflow 
Task queue error 
Buffer overrun-2 
Timeout 
Halt I/O 
Illegal command 
Memory fault-l 
Memory fault-2 
Illegal lu 
Illogical status 
Power fail 
Illegal condition 
Illegal 
translation table 
Queue empty 


Queue overflow 
DIOS error 


ee OD EN ET Ces ae ET Eee ge gees ome eee eee Ee Ge Ser ee ee ae eer cer eee 48m Gee eee em ore Gee en Ee eee eee cee ome ee ee ere One me ere ere SE Oe ee en eee mee ee ns me ame cee ee ae wee ow ame eee oe om owe wee oe 
TT ee ee er ee ee er er oe or 


No errors 

Line delete caused termination 
during read 

Break detected during write 
Break detected during read 
Terminated by data error (see 
bits 4 and 5) 

Framing or stop-bit error 
Reverse channel error 

Lost carrier on read 

Lost clear-to-send on write 
Data set not ready 

Adapter not present 

Character overflow 

Ring status detected during 
data transfer 

Busy and/or. done bits in 
chained buffers bad; may 
indicate priority too low 
Number of commands executed 
greater than 255 

Task queue full, invalid, or 
nonexistent 
Buffer-management~routine error; 
may indicate priority too low 
Timeout 

Halt I/O request aborted I/0 
Command or modifier not valid; 
e.g. switched line not 
connected : 

Memory fault in referencing 
data 

Memory fault in referencing 
buffer 

logical unit illegal (not SVC 
15 or not assigned) 

Device status not valid; might 
be hardware problem 

Power failure occurred during 
I/O 

Illegal software condition 
detected; might be caused by 
user-written drivers 

Attempt to use a nonexistent 
translation table 

Queued-buffer list empty 
Queued-buffer list overflow 
DMA I/O system (DIOS) hardware 
error 
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Byte 4 indicates the number of commands’ executed. This 
information, returned by the driver to the u-task, consists of 
the number of DCWs fetched and executed (not necessarily error 
free). 


The next three bytes, provided by the u-task, must contain the 
address of the first halfword of the user DCW chain. A DCW chain 
consists of consecutive driver command halfwords with their 
respective chain option bits set. DCWs are halfwords, each of 
which specify to the driver a particular functional operation to 
be performed, such as read or write. They also specify certain 
options applicable for the duration of the command. Figure 3-4 
shows the format of the DCW. 


2879 


| | | | | | Command { Driver 
| | | | | Reserved | modifier | command 


Bits: 0° 1 2 3 4 5 6 7 8 9 10 #11 #142 443 #14 =~ =«15 


Figure 3-4 Driver Command Word Format 


Table 3-2 shows the options enabled by setting the appropriate 
bits in the flags field of the DCW. 


TABLE 3-2 DRIVER COMMAND OPTIONS 


| FLAG | DESCRIPTOR | DESCRIPTION | 
Bit 0 Chain command After this command is executed, if 


this bit is set, the next command 
in sequence is-executed. Other- 
wise, the driver terminates. 


If set and enabled by the function 
code, atrap indicating command 
trap is generated to the calling 
task before this command is 
executed. 


| 
| 
| 
| 
| 
Bit l | Command trap 
| 
| 
| 
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TABLE 3-2 DRIVER COMMAND OPTIONS (Continued) 


If set and enabled by the function 
code, a buffer trap is generated 
after each buffer is transmitted 
or filled. 


| 

| 

| 

| 

| 

| If set, an error timer is 
| initialized before the command is 
| executed. If the timer expires 
| before the command goes to comple- 
| tion, the entire SVC 15 is aborted 
| with a timeout status. 

| 

| 

| 

| 


If not set, the timer is stopped 
and the command does not timeout. 


There are separate error time 
values for read and write. 


The next fullword in the parameter block returned by the driver 
to the u-task consists of two halfwords. They indicate, 
respectively, the length of the last read and the length of the 
last write performed by this I/O call. 


The remainder of the parameter block consists of data fields 
required by the DCW chain. Each data field consists of a l-byte 
code and a 3-byte data address. Data codes indicate the type of 
buffering desired. The data address always points to the data 
required by the corresponding DCW. (This could be no data or one 
Or more data fields, depending on the particular command.) See 
Appendix A for the DCW halfword binary format. See the OS/32 
Basic Data Communications Reference Manual for a detailed 
description of data codes and buffering techniques. Buffers are 
described later in this chapter. 


3.3 COMMANDS SUPPORTED 


The asynchronous line driver supports the following commands: 


@e Null type: 


- XFER 
- CXFER 
- WAIT 
- NOP 
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e Control type: 


EXAMINE 
RING/WAIT 
ANSWER 
DISCONNECT 


@ Read type; using standard data communications subsystem buffer 
management: 


~- READ 
- READ1 
-  READ2 


@ Prepare type; for one single character: 


- PREPARE 


@ Write type; using standard data communications subsystem 
buffer management: 


- WRITE 
- WRITE1] 
- WRITE2 


@e Hold type: 


- HOLD space (transmit break) 


@ Mode type; used to modify certain programmable adapter 
options, allowing one asynchronous line driver to communicate 
with different types of asynchronous terminals: 


- Tout 

- CMD2 

- RCMD 

- WCMD 

~ RDISABLE 
- WDISABLE 
- DISC 

- TRANSL 

- SPCHAR 


All mode commands receive an address from a data field. This 
address points to a byte, halfword, or fullword field containing 
an output instruction or an error timeout value. The contents of 
this field are stored in the DCB for use by the asynchronous line 
driver. 
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If the default values specified in the DCB are acceptable, no 
mode commands need be executed. Once a value is changed by a 
mode command, the only means of restoring the default condition 
is by a mode command specifying the correct value. It is 
necessary to coordinate such modification if access is being 
shared by more than one program. 


The chain command and command trap bits of the DCW can be used in 
conjunction with the mode commands. 


These commands are described in detail below: 


MODIFIER/ 
COMMAND | 
COMMAND BYTE (HEX) MEANING 


XFER XX10 — This command obtains one data field, 
which specifies the address of the next 
DCW. This command must be chained. 


CXFER XX18 This command obtains two data fields; the 
first specifies the address of two 
consecutive halfwords. The first 
halfword is a mask that is ANDed with the 
present status of the communications 
subsystem. The second halfword is 
compared with the result from above. If 
equal, the next command address is 
specified by the second data field. If 
unequal, the next command in sequence is 
executed. This command must be chained. 


WAIT XX08 This command obtains one data field that 
specifies the address of a halfword 
containing a timeout count in units of 
100 milliseconds. This delay is 
performed before continuing with command 
word chain processing. 


NOP XX00 This command obtains one data field, 
which is ignored. It is useful for 
reserving space in both the command chain 
and the DCW chain. The data field of 
this command must specify a valid 
address. 


EXAMINE XX01 This command obtains one data field. The 
value obtained specifies the address of 
a writable byte into which the status of 
the device is’ stored. The last known 
device status is fetched froma byte in 
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RING/WAIT 


ANSWER 


XX09 


XX11 


DISCONNECT xXx19 


READ 


XX02 


memory that is maintained by the driver 
during I/O activity. If the byte is 
nonzero, its contents are returned to the 
user and it is reset to 0. If the byte 
is 0, a sense status is performed on the 
device and the device status is returned 
to the user. 


This command fetches no data fields. 
Interrupts from the adapter are enabled; 
however, the data terminal ready lead to 
the modem is not. The command terminates 
when an interrupt is received with ring 
status set. If chain command is set, 
execution continues with the next 
command; otherwise, the driver 
terminates. If timeout is set, the 
command only waits as long as the value 
specified in the write error time value. 
If this interval expires, timeout error 
Status is set. If timeout is not set, 
the command waits indefinitely. 


For nonswitched lines and switched lines 
already connected, this command 
immediately terminates. For dial-in 
lines that are unconnected, the data 
terminal ready lead to the modem is 
enabled, causing the modem to answer when 
the data set indicates it is ready for 
I/O. Timeout and chain commands are 
handled as described in the RING/WAIT 
command. 


This command disables the data terminal 
ready lead to the modem, causing a 
disconnect on a switched line. The 
command waits for one second, then 
continues to the next command (if chain 
command is set) or terminates (if reset). 


This command obtains either one or _ two 
data fields, depending on which one of 
the three standard data communications 
buffer management techniques is specified 
in the data code of the first data field 
obtained. For indirect and chained 
buffers, one data field is obtained; for 
direct and queued buffers, two fields are 
obtained. All buffers must be in the 
same logical segment of the task as the 
address contained in the first data field 
of the parameter block. The command 
terminates normally when all buffers are 
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READ1 


READ2 


PREPARE 
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XXOA 


XX12 


XX03 


exhausted or a termination character is 
received. If ‘timeout is requested and 
the I/O does not terminate normally 
before the timer expires, then I/O is 
aborted and timeout status is returned. 
The special characters recognized during 
read and their enable mask values are 
shown in Table 2-4. 


This command obtains one data field that 
specifies the address of a writable byte 
into which a character is read. The 
command terminates after reading one 
character. If timeout is requested in 
the command, the read error time value 
(changeable by a MODE command) is used. 


This command is similar to the above 
command except that two bytes are read 
and stored. 


This command obtains one data field that 
specifies the address of a l-byte data 
area. Characters are read from the 
adapter, and the command terminates when 
a character is read equal to the contents 
of the data area. The characters’ read 
are not stored and are lost. 


Receipt of break can optionally fulfill 
the requirements of the PREPARE command 
(controlled by the special | character 
write enable bit x'OOO1'). When the 
prepare criterion is fulfilled (correct 
character received, or break if enabled) 
the command is considered executed and 
the next command, if chained, is 
executed. If timeout is specified in the 
command, then the read time value is 
used. The entire SVC 15 terminates with 
timeout status if the PREPARE command is 
not satisfied within the allowed time. 


NOTE 


The special case of PREPARE 
chained to a READ results in a 
look-ahead to set up the read 
buffer. In this way, an input 
stream can be searched for a 
special key character and then 
the text that follows can be 
read. 


WRITE 


WRITEL] 


WRITE2 


HOLD 
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XX04 


XXOC 


XX14 


XX05 


This command obtains either one or _ two 
data fields based on the same criterion 
as in READ. The command terminates 
normally when all buffers are exhausted 
or a termination character is detected in 
the data being transmitted. 


The asynchronous line driver performs 
special character recognition during 
write operations in an analogous’ fashion 
to the read. Each character is enabled 
via a halfword bit mask changed via _ the 
mode SPCHR command. 


Backspace and line delete characters are 
of no practical value in awrite 
Situation, and none are defined. The 
ending characters for write and their 
enable masks are shown in Table 2-4. 


This command obtains one data field that 
specifies the address of a byte of data 
transmitted to the adapter. The command 


terminates after the character is 
transmitted. 


Same as WRITE], except two characters are 
transmitted. If detected in a data 
stream being transmitted, the ending 
character is transmitted and the write is 
terminated. 


NOTE 


If echoplex is specified for 
READ, an extra pad character 
(X'FF') is sent after the last 
character is written for all 
WRITEs. (The pad is not sent 
if the image translation table 
is specified.) 


Chain command and command trap are the 
valid flag bits. This command obtains 
one data field that specifies the address 
of a halfword containing a timeout count 
in units of 100 milliseconds. The driver 
transmits a continuous space (line break 
Or a Character equal to zero) for the 
specified interval, after which the 
command terminates. Clock resolution is 
+0, -l1 clock unit of 100. 
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TOUT XX06 This command obtains the address of two 
halfwords that specify error timeout 
values in seconds. If any command 
specifies timeout, this time value is 
placed into the DCB.TOUT field of the DCB 
and is decremented every second by the 
system clock. If the particular command 
is not completed within the allotted 
time, the entire SVC 15 is aborted and 
the timeout status bit is set. If no 
other encoded errors are indicated in the 
status field, the timeout code is also 
placed in the encoded portion of the 
status. 


If the timeout status bit is set and the 
encoded error is not timeout, the encoded 
error occurred first and might, in fact, 
be the reason for the timeout. 


There are separate time values for. read 
and write. The data field of the MODE 
TOUT command specifies a fullword. The 
first halfword obtained by mode TOUT is 
the time value for all READ commands’ and 
the second halfword is the time value for 
all WRITE commands. Zero is not a valid 
time value. Precision range is +0, -1l 


second. 
2880 Echoplex 
Disable Trans 
Enable LB 
DTR RCT WRT/ 
a 
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Figure 3-5 Adapter Command 1 (CMD1) 


RCMD XX16 This command obtains the address of the 
byte specifying the asynchronous’) driver 
adapter command used for read operations. 
This command is then stored in the 
DCB.MOCR field. The asynchronous’ driver 
communicates with the adapter through 
this command. For example, whenever an 
adapter is to perform a read operation, 
the driver issues the read command stored 
in the DCB.MOCR field by RCMD. See 
Figure 3-5. 
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RDISABLE 


WCMD 
Or 
WDIS 
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XX26 


XX1E 


For read operations the adapter command 
should normally specify: 


ENABLE+ 

DATA TERMINAL READY + (DTR) 

The proper combination for read and 
(optionally) echoplex. See the 0OS/32 
Basic Data Communications Reference 
Manual. 


This must be consistent with the adapter 
type, its particular strapping, and the 
modem. If the echoplex is used (normally 
only on 4-wire) it should be specified 
only in the READ command. See Figure 
3-5. 


This command obtains the address of the 
byte containing the adapter command that 
is stored in the DCB.DOCR field for use 
by the driver. This adapter command 


disables interrupts from the read side of 
the adapter after each completed DCW READ 


and WRITE command and after any error 
conditions. It should normally leave the 
adapter and modem in the read mode and 
specify: 


DISABLE + 

DATA TERMINAL READY+ 

Proper combination for READ. See Figure 
3-5. See the 0S/32 Basic Data 
Communications Reference Manual. 


This command obtains the address of the 
write adapter commands that are stored in 
the DCB.MOCW and DCB.DOCW fields for use 
by the asynchronous driver. 


The write commands WCMD and WDIS are used 
Similarly to the READ commands and should 
normally specify: 


WCMD: ENABLE+ 
DATA TERMINAL READY+ 
Proper combination for WRITE 


See the OS/32 Basic Data Communications 
Reference Manual. 
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CMD2_ 
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TRNSL 
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XXOE 


WDIS: DISABLE+ 
DATA TERMINAL READY+ 
Proper combination for WRITE 


See Figure 3-5 and the OS/32 Basic Data 
Communications Reference Manual. 


The write commands leave (or disable) the 
line in the write state, with data 
terminal ready; while the read commands 
disable the line in the read state, with 
data terminal ready. This allows the 
user to string several write or. read 
commands together so the disable at the 
end of each command does not result in 
dropping and/or subsequent raising of 
request to send (RQ2S), unless the 
command does indicate a change of state. 


The format of the I/O command byte 2 
obtained by the mode CMD2 command is 
shown in Figure 3-6. Because 
programmable adapter options can be set 
via the mode CMD2 command, the bit 
pattern for the CMD2 is determined by the 
user's particular installation. Setting 
bit 7 to 0 allows the user to select’ the 
following clock adapter options: number 
of bits, number of stops, and parity 
(odd, even, or none). 


NO. 


Clock No.Bits Stops Parity 
Fe et tN ee Mil di i 


—sTw ee Peewee es TP eOeZ wT eB ewe www ee ww we ee = 


Figure 3-6 Adapter Command 2 (CMD2) 


XX00 


This command allows the user to modify 
the default translation table. It 
obtains the address of a one-byte field 
specifying the type of translation table 
to be used by the driver. This byte can 
contain the following values: 


X'O00' Normal translation (7-bit 
ASCII, strip off and ignore 
parity) 


X'O1' 8-bit image translation 


The address of the translation table to 
be used is stored in the DCB.XLT field. 


The only ending characters recognized by 
the image translation table are CR (X'0OD' 
or X'8D') and ETX (X'03' or X'83'). The 
characters must be enabled to become 
effective. 


SPCHR XX4E This command obtains the address of a 
fullword field specifying the special 
character enable mask halfwords for’ read 
and write operations. SPCHR stores the 
halfwords in the DCB.SPCR and DCB.SPCW 
fields for use by the asynchronous line 
driver. The first halfword is the 
read-enable mask, and the second halfword 
is the write-enable mask. The format of 
each mask is shown in Table 2-4. 


3.4 SPECIAL CHARACTER PROCESSING 


The special characters that can be used during read or write 
operations are divided into four major categories: 


e Ending or Terminating Characters - These characters, when 
encountered in the data stream, are stored in the buffer or 
sent down the communications line and result in termination of 
that particular READ or WRITE command. If the command is 
chained, the next command is executed. See Table 2-4. 


e Line Delete Characters - When these characters are detected in 
the input data stream, the line delete special character bit 
is set in the status halfword. If the line delete is also 
enabled as a terminating character, the entire SVC 15 is 
aborted with the encoded status indicating line delete. See 
Table 2-4. 


@ Backspace Characters - These characters, when encountered in 
the input stream, result in the equivalent of a backspace; 
i.e., the previous character is backspaced over. See Table 
2-4. 


@ Miscellaneous Other Characters - Miscellaneous characters have 
variable meanings, depending on the type of terminal involved. 
These characters can be used to turn off or on aée_e specific 
operating character for a predefined terminal. See Table 2-4. 


Since several terminal or line procedures use different 
characters for the previous purposes, the asynchronous line 
driver recognizes several characters in each category. Special 
character recognition for each character can be separately 


3-16 48-047 FOO RO1 


enabled or disabled by a bit mask. The mask consists of two 
halfwords that indicate the characters this particular device 
allows for a given purpose on read and write. These two 
halfwords are modified by the mode SPCHR command explained in the 
description of the mode commands. 


When using chained or queued buffers, it is not possible to 
backspace over buffer limits. (The data communications subsystem 
allows the user to manipulate buffers other than those currently 
in use by the driver.) If a backspace that would back over a 
buffer limit (except the first buffer) is attempted, the 
backspace function is disabled and the backspace over buffer 
limit status is set. The result is that this and all future 
backspace characters are stored in the buffer. Reissue the read 
or attempt to perform user backspace handling if this status 
occurs. 


ESC Setting the escape bit allows 
receipt of ESC during a write to be 
treated as if a break were received. 
Escape is ignored if this bit is 
reset. 


BUFFER CONTROL The Carousel control codes (DC2 and 
DC4 in Table 2-4) are sent by the 
Carousel to pause (DC4) and continue 
(DC2) the computer output as_ the 
Carousel's input buffer fills or 
empties past predetermined limits. 
The write enable bit for the 
Carousel must be set to allow the 
asynchronous line driver to react to 
these control characters during 
output. If the Carousel control 
code bit is reset, receipt of these 
characters during write is ignored. 


NOTE 


The control characters 
DCl1 and DC3 used by the 
remote printer are 
handled in the same 
Manner as DC2 and DC3, 
respectively. 
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3.5 DEFAULT VALUES 


The default values, assembled in DCB144, DCB145, DCB146, DCB147, 
DCB148, DCB149 and DCB150 for the previous mode commands are 
shown below: 


TOUT DC H'30',H'30' 30 seconds for read, 30 seconds 
for write 

CMD2 DB xX'38! 8-bit data characters, no parity, 
2 stop bits 

RCMD DB xX'7l'! ENABLE, DTR, ECHOPLEX, READ 

WCMD DB X'63! ENABLE, DTR, WRITE 

RDIS DB xX'Al' DISABLE, DTR, READ 

WDIS DB X'A3! DISABLE, DTR, WRITE 

DISC DB X'Bl' DISABLE, READ 

TRNSL DB 0 7-bit ASCII, strip off parity 


SPECCHAR DCX 81E8 ,0000 All characters enabled 
The special character format for DCB144 is: 
SPECCHAR DCX F9ED,6004 


Ending sequence count for DCB149 and 150 is: 


SYCT DB X'‘'2' LF, CR as ending sequence 


3.6 BUFFERS AND TRAPS 


The following information on buffers appears in Chapter 3 of the 
OS/32 Basic Data Communications Reference Manual. 


SVC 15 specifies the first entry in each of the following two 
related chains used to define the request: 


1. The DCW chain, which specifies the sequence of operations to 
be performed by the driver; i.e., READ, WRITE, etc 


2. The data field chain, which specifies the arguments’ required 
by each driver command in the DCW chain 


SvC 15 activates the line driver which fetches and executes’ the 
first DCW in the DCW chain. Once autonomous driver execution is 
started, control is returned to the user task with the condition 
code indicating the result of the call. If no error is 
encountered in initiating the operation specified by the first 
DCW, the status field of the SVC 15 parameter block is set to 
indicate that the line driver is active with the request. For 
the remainder of the I/O request, as each command operation is 
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completed, the next operation specified in the DCW chain is 
fetched and executed by the line driver at the priority of the 
calling task. This sequence of fetch and execute is repeated 
until the entire DCW chain is interpreted or an error condition 
is encountered. 


To monitor the progress of SVC 15 and provide facilities for 
buffer management, the task can specify that a trap is to be 
generated at the start of the driver command execution, at _ the 
time the line driver starts to use a buffer, and/or at 
termination of SVC 15. These traps allow the task to synchronize 
execution with the concurrent processing of the SVC 15 request. 
When traps are enabled, and a trap-causing event occurs, the task 
trap handling routine is given control before any subsequent task 
level instruction can be executed. Remember that the 
trap-handling routines are operating at a lower priority than the 
line driver; thus, several entries can be made to the task queue 
before the trap handling routine completes processing a single 
entry. 


Both the DCW and data field chains are usually interpreted by 
fetching the next required entry from the memory location 
immediately following the last entry processed. Special entries 
allow each chain to be contained in nonadjacent areas in memory. 
There is a DCW chain entry specifying that the data field points 
to the next DCW chain entry. Similarly, there is a data field 
chain entry pointing to the next entry in the data field chain 
instead of containing the address of a data area. The only 
restriction is that all buffers specified in one SVC 15 request 
must be contained in the same logical program segment. See the 
OS/32 Application Level Programmer Reference Manual _ for a 
discussion of program segments. 


The user uses the SVC 15 parameter block to specify a control 
sequence to be performed by pointing to a DCW chain. Through the 
SVC 15 parameter block, the user also specifies the data areas 
associated with each driver command by pointing to a chain of 
data fields. A data field, illustrated in Figure 3-7, consists 
of a l-byte code indicating the data field type and a 3-byte 
pointer to the data described by the data field. 


2882 


Bits: 0 1 2 3 4 5 6 7 8 9 10 11 #12 #143 #714 «15 


Figure 3-7 Supervisor Call 15 (SVC 15) Data Field 
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DATA CODE (HEX) CONTENTS 


00 Address of direct buffer 

04 Address of indirect buffer 

08 Address of chained buffer 

OA Address of queued buffer list 


3.6.1 Buffer Types 


There are three buffer types used by the asynchronous line 
driver: 


e Direct 


e Indirect 


e Chained or Queued 


These buffer types and their respective data codes are described 
in the following sections. 


3.6.2 Direct Buffers (Data Code x'00') 


A direct buffer requires two data fields in the data field chain. 
These data fields contain the start and end addresses of the 
buffer. A direct buffer is similar to an SVC 1 data buffer. The 
start address points to the first data character; the end address 
points to the last data character. A l-character buffer has a 
start address equal to the end address. Direct buffers can begin 
on any byte boundary. See Figure 3-8. 
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Svc 15 Parameter Block 


wr BE BPE wera ewran ae were awr as FeO were wr snr awe wrereraewrwrwwrarerewawrereran wae wre e en een a @ = 


} 990 | Begin address | 


} 00 | End address { 


Figure 3-8 Direct Buffer 


3.6.3 Indirect Buffers (Data Code xX'04') 


An indirect buffer is specified by one data field containing its 
Start address. The buffer itself contains all required size 
information. The first halfword indicates the number of bytes 
available in the buffer. The second halfword of the buffer is 
updated by the driver; it indicates how many bytes of data were 
actually transferred by the I/O operation. An indirect buffer 
can be aligned on a halfword boundary. See Figure 3-9. 
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SVC 15 Parameter Block 


2884 


Indirect Buffer 


Halfword \| Bytes avail =n | 
Aligned Le ee ee ee ee ee a ne | 
| Bytes used | 

les Reimer gen smir a ae co ce a eer | 

| Byte 1 Byte 2 | 
Peete ape er eee eee ee | 

| Byte 3 Byte 4 | 

To ad aie pica a eee wees | 

| Byte § Byte 6 | 

deere semen elena easeegens eran i 
nee T 

| Byte n-1 Byte n | 

Bits: 0 15 


Figure 3-9 Indirect Buffer 


3.6.4 Chained Buffers (Data Code X'08') 


Chained buffers are specified by one data field containing the 
address of the first buffer in the chain. Chained buffers are 
like indirect text buffers but have an additional fullword at the 
beginning. This fullword is called the link word and can contain 
the address of another chained buffer. Thus, two or more buffers 
can be linked together into a chain. The last buffer ina chain 
of linked buffers contains a zero link word indicating the end of 
the chain. Chained buffers can also be configured into a closed 
chain (a ring) if the last buffer links back to the first buffer. 
See Figure 3-10. 
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SVC 15 Parameter Block 


BO le et te eee re a rece ehh ie oe og rk net oe 
| | | 
(eae eign hci a aciataal east is ecipn aia | 
Data | OS/OA | Begin Address | 
ELeld. (ses eee a t- Herre tes Sse Sere Sse er Sse HS | 
| | 
Bits: 0 31 
Chained Buffer 
| Flags | Link word | 
pes ee gee nae eee rea enenee ess | 
| Bytes avail=n | Bytes used | 
Tos mat ain iain mas Ge i 9 ce | 
| Byte 1 | Byte 2 | Byte 3 | Byte 4 | 
ee eee cn ge anne | 
| Byte 5 | Byte 6 | Byte 7 | Byte 8 | 
[nar arer genre pee oe Sate a ge me eee rie per ene yr meee | 
| | 
Ag erm RT Ne Nap OG Oe ee er dee ee ee 
Poonec nat eeo no 1 
| Byte n | 
Bits: 0 31 


Figure 3-10 Chained/Queued Buffer Format 


The first byte of the link word is used for certain flags 
indicating conditions or options within the buffer. Chained 
buffers must be aligned on a fullword boundary. See Figure 3-1l. 


A task can manipulate the links and data of chained buffers while 
I/O activity is in progress. Bits 0-7 of the link word (the flag 


byte) are used to coordinate driver and u-tasks as shown in 
Figure 3-ll. 


2886 Busy Done 


| | | Reserved for | 
ee | | driver use | 


Figure 3-11 Chained/Queuved Buffer Link Word Flag Byte 
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BIT 0 BIT 1 


0 0 A buffer is available for use by the driver. 


The link word contains a valid address or 
zero. 

1] 0 The driver is currently using this buffer for 
I/O. 


The user task must not change: 


- Data 
- Size values 


- Link word 
- Flags 


1 1 The driver has finished using the buffer. The 
driver will not begin to use this buffer again 
Should it reoccur in the chain. A u-task can 
change any value, and the bytes used field 
reflects actual transfer. 


0 1 Invalid setting. The driver treats it as if 
both busy and done bits were set to one. 


3.6.5 Queued Buffers (Data Code X'0A') 


Queued buffers are specified by two data fields. Each data field 
contains the address of a standard Perkin-Elmer circular list. 
The first list (list 1) specifies a queue of buffers from which 
the basic communications subsystem removes buffers for 
input/output operations. The second list (list 2) specifies a 
queue of buffers that the basic communications subsystem returns 
to the applications program following I/O activity. List 1 may 
coincide with list 2. Figure 3-14 illustrates the standard 
Perkin-Elmer circular list. The basic communications subsystem 
removes buffers from the top of list 1 by executing a remove from 
top of list (RTL) instruction and returns buffers to the bottom 
of list 2 by executing an add to bottom of list (ABL) 
instruction. 


The format of each individual queued buffer, whose address is 
contained in the list, is identical to the format of a chained 
buffer. As with other buffer types, the circular list 
definition, and all buffers included within the list, must be in 
the same logical segment. Restrictions on modification of the 
buffer control fields during I/O apply equally to queued buffers 
and chained buffers. 


When an I/O buffer is removed from list 1 by the basic 


communications subsystem, the link address field is cleared to 
prevent error verification ambiguity, and the address of the 
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buffer is maintained solely within driver control storage. The 
buffer is, in effect, not available to the applications program 
during I/O. | 


The busy and done bits within the flag byte are used analogous to 
chained buffers. When I/O is complete, the buffer is returned to 
the bottom of list 2. Simultaneously with I/O operation, the 
applications task can add new I/O buffers to the bottom of list 
1 or remove completed buffers from the top of list 2. Only list 
processing instructions (RTL, RBL, ATL and ABL) can be used by 
the applicatons task to modify a circular list. Any other 
attempt to modify circular list control fields could result ina 
loss of control. 


Should the communications subsystem attempt to return a buffer to 
list 2 and not be able to complete the action because the list is 
full, a queue overflow (X'24') error termination results. The 
addresses of any buffers currently being used for I/O are then 
chained to the bottom buffer in list 2 to return them to the 
applications task. As the list address field is initialized to 
zero at the start of I/O, a nonzero link field should be checked 
by the applications task to detect buffers returned due to a 
queue overflow error condition. 


The buffer trap mechanism is available for queued buffers. To 
conserve processor time, this mechanism is generated only when a 
buffer is added to a previously empty list 2, indicated by the 
status returned by the last RTL or RBL. This technique requires 
an application program to process all buffers in list 2 whenever 
a trap interrupt occurs. See Figure 3-12. 
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2887 


CIRCULAR LIST FROM WHICH 
DATA COMMUNICATIONS 
OBTAINS BUFFERS 


CURRENT TOP 
OCCUPIED 
SECTION 


SVC 15 NEXT BOTTOM 


PARAMETER BLOCK 


16 31 


0 15 
NUMBER OF SLOTS NUMBER USED 
CURRENT TOP NEXT BOTTOM 


CIRCULAR LIST TO WHICH 
DATA COMMUNICATIONS 
RETURNS BUFFERS 


0 15 ,16 31 


NUMBER OF SLOTS NUMBER USED 
CURRENT TOP NEXT BOTTOM 


CURRENT TOP 


OCCUPIED 
SECTION 


NEXT BOTTOM 


Figure 3-12 Conceptual Circular List and Format 
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The first two fullwords contain the list parameters. Immediately 
following the parameter block is the list itself. The first 
fullword in the list is designated slot 0. The remaining slots 
are designated 1, 2, 3, etc., up to a maximum slot number equal 
to the number in the list minus one. An absolute maximum of 
65,535 fullword slots can be specified. (Maximum slot 
designation is equal to X'FFFE'.) 


The first parameter halfword indicates the number of slots 
(fullwords) in the entire list. The second parameter halfword 
indicates the current number of slots being used. When this 
halfword equals zero, the list is empty. When this halfword 
equals the number of slots in the list, the list is full. Once 
initialized, this halfword is automatically maintained. It is 
incremented when elements are added to the list and decremented 
when elements are removed. 


The third and fourth halfwords of the list parameter block 
specify the current top-of-the-list and the next 
bottom-of-the-list, respectively. These pointers are also 
automatically updated. 


3.6.6 Traps 


Two things are required to Perrone a trap when using the task 
queue service method: 


1. In the TSW of the user-dedicated locations (UDL), the SVC 
queue entry enable bit must be set. 


2. In the SVC 15 function code and in the DCW, the appropriate 
bits must be enabled for the particular trap desired. See 
Figure 3-2 and Figure 3-4. 


When a condition causes a trap, the current TSW (status and 
location) is saved in the appropriate area of the UDL. A new TSW 
(status location counter) is loaded from the appropriate area in 
the UDL. The new TSW controls the traps or task queue entries to 
be allowed during the execution of the trap service routine. The 
trap routine must save general and floating point registers as 
necessary prior to servicing the trap. An SVC 9 (load TSW) is 
used to load the saved (old) TSW, returning control to the normal 
execution sequence. 


The SVC 15 parameter block with the trap bits enabled can be 
added to the user task queue, causing a trap. All traps are 
transmitted to the calling task before execution of the command. 
The format of the items added to the task queue is shown in 
Figure 3-13. 
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Figure 3-13 Task Trap Format 


The code indicates the reason the entry was placed on the queue. 
The SVC 15 reason code for each of the four kinds of traps is 
shown in Table 3-3. The parameter entered on the task queue is 
the address of the SVC 15 parameter block in all cases. 


TABLE 3-3 SUPERVISOR CALL 15 (SVC 15) TRAPS 


| | REASON | 
| SVC 15 TRAPS | CODE | MEANING 


Command trap | This trap is set by a bit 
| in the DCW and a bit in 
| the function code. It is 
| generated to the calling 
| task before execution of 
| the command. 

Buffer trap X'OB' | This trap is set by a bit 
| in the DCW and enabled by 
| the function code. It is 
| generated when the first 
| character is transferred 
| and after each buffer is 
| transmitted or filled. 
| 

Termination trap X'Oc' | This trap must have a bit 
| set in the function code 
| and in the Svc 15 queue 

| entry enable in the’ TSW. 
| It is generated when’ the 
| driver terminates. 

Halt I/O trap X'OD' | This trap is generated in 

| the place of the x'oc' 

| trap if I/O is terminated 

| as a result of a HALT I/O 

| call. 
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3.7 HOW TO USE THE ASYNCHRONOUS LINE DRIVER 


The asychronous line driver can be used to build a data file by 
working interactively with an editing VDU. The user begins by 
providing the information specified by the format appearing on 
the screen. When the user enters the data required (refer to 
Appendix C for a sample printout), the interactive process 
begins. The system continues presenting formats on the screen 
for user response. This interactive process continues until it 
is terminated by the user. 
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CHAPTER 4 
TELETYPE (TTY) /VIDEO DISPLAY UNIT (VDU) TERMINAL MANAGER 


4.1 INTRODUCTION 


This chapter describes the OS/32 Basic Data Communications 
TTY/VDU terminal manager (INITMASY), which requires’ the 
asynchronous line driver. 


The TTY/VDU terminal manager is a nonbuffered terminal manager 
that supports remote asynchronous teletypes, non-editing VDUs, 
graphic displays, or Carousel 300 terminals in a user program 
compatible with the local fTTY/VDU driver. It provides a 
device-independent supervisor call 1 (SVC 1) access capability 
featuring data optimization on output and automatic 
special-character processing on input. It processes the extended 
options format, connects and disconnects, and is supported by 
high-level languages. 


The TTY/VDU terminal manager occupies approximately 950 bytes; 
and the DCB/CCB, 400 bytes. | 


In addition, the terminal manager requires support from the 
asynchronous SVC 15 line driver and the system support module. 
As no data buffering is performed, a line control block (LCB) is 
not required. 


A terminal manager has the logic to initiate, maintain, and 


terminate transmission to a logical device called a terminal. 
This level of support allows: 


e A user program to access local or remote peripherals without 
recompilation 


@ User access to remote facilities without regard to the line 
protocols,codes, and functions of those facilities. 


e A user application to be supported by a standard terminal 
Manager without implementing special purpose software 
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4.2 TERMINALS 

The TTY/VDU terminal manager and hardware interfaces support the 
following remote terminals and any other terminal that meets EIA 
RS232C interface specifications: 

e ASR-33 TTY keyboard/printer 

e ASR-35 TTY keyboard/printer 

e Nonediting VDU 

e Graphic display terminal 

e Carousel 300 terminal 

@e Carousel 300 terminal with electronic format control 

@ Models 550 and 550/B nonediting terminals 

@e Model 1100 nonediting terminal 

This is a nonbuffered terminal manager that supports the ASCII 
character set only. 

The extended device code (DCB.XDCD) must be initialized at system 


generation (sysgen) time. A description of the communications 
subsystem extended device code is shown in Figure 4-1. 


2906 
| Line | Line |Explicit| | 
| Reserved|status|protocoll|connect | Clock | Reserved 
| code | code |required|Selection | 
Bits: 0 3 4 5 6 7 8 9 10 11 12 15 


Figure 4-1 Extended Device Code Halfword 


LINE CODE DECIMAL VALUE 
Line Status 
Direct connection 0 
Leased line 1024 
Dial in/manual dial 2048 
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LINE CODE DECIMAL VALUE 


Line Protocol 


Half duplex 4-wire 0 
Half duplex 2-wire — 768 
Simplex read “ 256 
Simplex write 512 
Explicit connect required 128 
Clock Selection 
Clock A 0 
Clock B 16 
Clock C 32 
Clock D 48 


4.3 SUPPORTED ATTRIBUTES 


This terminal manager supports read, write, halt I/O, wait, 
unconditional proceed, image, variable record lengths up to 72 
characters (M33), 74 characters (graphic display terminal), 80 
characters (M35 or nonediting VDU), and 132 characters (Carousel 
300). All other I/O transfer requests are returned as errors. 
All command requests are ignored.. 


4.4 SUPPORTED FUNCTIONS 


The OS/32 Basic Data Communications TTY/VDU Terminal Manager 
supports the functions of read ASCII, write ASCII, and read or 
write image. For more information of device independent 
functions (SVC 1), see the OS/32 BUR SPyanoe Call (SVC) Programmer 
Reference Manual. 


Read ASCII Data read is masked to 7-bit ASCII. Data is 
read until the buffer is full or a carriage 
return is found, whichever occurs first. 
Upon termination, a carriage return/line feed 
sequence is sent to the printer. Typing the 
Character # causes the line input to be 
ignored, an LF/CR/CR sequence to be output, 
and the read operation to be restarted. 
Typing the character (shift-O), BS (ASCII 
backspace), or cursor left causes the 
previous character entered to be ignored. 


Write ASCII The buffer is scanned to eliminate trailing 
blanks. Data is output until the buffer is 
exhausted or until a carriage return is found 
in the data _ stream. A line feed is 
automatically appended to the deleted CR. If 
no CR is detected, an LF/CR/CR sequence is 


output. 
Read or Write None of the previous formatting actions 
Image occur. The amount of data requested is typed 


Out or read in, without masking, to 7-bit 
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ASCII, eliminating trailing blanks, checking 
for # characters, or detecting or appending 
Carriage returns or line feeds. On image 
read, however, an ASCII CR is detected as an 
end of line terminating control character. 


4.5 THE PERKIN-ELMER CAROUSEL 300 TERMINAL 


The TTY/VDU terminal manager supports the Perkin-Elmer Carousel 
300 terminal with or without electronic format control. The 
Carousel 300 is a versatile, high quality, 30-character per 
second computer terminal designed for timesharing, data 
communications, and special applications requiring the 
availability of a local or remote terminal. The terminal 
consists of the carousel serial impact printing mechanism, a 
76-key alphanumeric keyboard with a 10-key numeric pad, a control 
panel, a power supply, and a molded cover case. Interfacing to 
the communications line or local processor is accomplished via 
the Standard RS232C interface. Refer to the Perkin-Elmer 
Carousel 300 Programming Manual. Other features include: 


e 132-character print line at 10 characters per inch 

@e 15-inch forms width capability 

e 128-character line buffer 

@ 32-character keyboard buffer to increase system throughput 


e Independently addressable horizontal and vertical print 
positions in increments of 1/10 inch and 1/48 inch, 
respectively 


e A peak speed of 40 cps 


The TTY/VDU terminal manager passes through to the terminal any 
of the following escape character sequences requested by SVC l: 


ESC 0 Set left margin - Causes the current print 
position to become the new left margin. Valid for 
print positions 0 to 127. A margin can be 
redefined by backspacing, spacing, or performing 
an addressable horizontal tab to the desired new 
Margin position, and then performing an ESC 0. 
Addressable horizontal- tabulation codes to the 
left of the margin are valid and do not affect 
Margin definition. 


ESC 1 Horizontal tab set - Electronically sets the 
current print position as a tab stop 
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ESC 2 


ESC 3 


ESC 4 


ESC 5 


ESC 7 


ESC P 


ESC P 


CONTROL L 


Addressable 
horizontal 


Addressable 
vertical 
tabulation 
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Horizontal tab clear - Electronically clears the 
current print position as a tab stop 


Clear all tabs - Clears all previously set tabs 


Ribbon up - Raises ribbon to printing position 
with a single-color ribbon or restores ribbon to 
black printing position from red when using a 
two-color ribbon 


Ribbon down - Lowers ribbon to stencil position 
with a single-color ribbon or to red ribbon 
position when using a two-color ribbon 


Reverse line feed - Moves paper 1/6 inch to the 
previous line 


Inhibit escapement - Causes print carriage to 
remain at last printed column position 


Restore escapement - Restores printing pitch to 10 
characters per inch 


Top of form - The control logic monitors’ the 
passage of a standard ll-inch, 66-line form 


through the printer. The form can be skipped in 


whole or in part when the code is received. 
Movement stops at the end of the ll-inch form and 
corresponds to the top of the next form. 


The initial setting of the top-of-form position is 
automatic and only requires the first manual 
positioning of the form with the platen knob. If 
power is turned off, the top of the form must be 
redefined when power is restored. 


The control logic allows direct forward and 
reverse tabulation of the print carriage to any of 
the 132 printing positions. Each tabulation 
position is reached by inputting a 3-code sequence 
from the data source. See Table 4-1 for coding. 


NOTE 


The firmware presets every eighth column 
as a tab stop when power is first turned 
on. 


The control logic allows’ the direct addressing 
of 127 vertical tabulation positions. Forward, 
up and/or reverse, down, movement of the paper or 
form can be achieved by entering the appropriate 
codes as shown in Table 4-2. 


TABLE 4-1 ADDRESSABLE HORIZONTAL TABULATION CODING CHART 


ERE 
| AAAS 


aK 
SEE TARIR RRS 
* ANAASISNSNNANS 
XANINSISASASARAN 


ESC + L,l or M,m or N,n 


48-047 FOO ROI 


TABLE 4-2 ADDRESSABLE VERTICAL TABULATION CODING CHART 


TERE 
RRRRIRRIRRISRRRIERE 
, AXAANAAIAAAA 
J ESNNSSNANARRERAR 
“NSAI 
* AAAIISANAANAN 
g NAAN 
* AAA 


CODE SEQUENCE: 


: 
= 
S 
= 


ESC +!or” 


$ (for reverse) 


ESC + # or 
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Vertical line The following codes are used to move the platen 
increments in increments of 1/48 inch: 


NO. INCREMENTS 
FWD (UP) REV (DOWN) (IN 1/48") 


ESC @ 

ESC A a 

ESC B b 

ESC C Cc 

ESC D-super- d- 
script 


subscript 


ESC E 
ESC F 
ESC G 


SND UI &m WHF © 


a ho 


Form length Control logic is set, on application of power, to 

codes a value equivalent to 1l inches on application of 
power, to a value equivalent to 11 inches for top 
of form. This value can be altered for any form 
length up to 127 lines by keyboard or u-task input 
of the codes shown in Table 4-3. 


NOTE 
The lil-inch top-of-form value is 


restored only on power down/power up or 
by entering the proper codes. 
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TABLE 4-3 FORM LENGTH CODING CHART 


NK 


AANA 
AAI © 
ASSERTS 
ASRS 
NIAAA 
ASIII 
NAAR 
VAAN 


CODE SEQUENCE: 


ESC + k or K 
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4.5.1 System Characteristics 


The Carousel 300 terminal responds to the input of serial ASCII 
data. When operating at 150 or 300 baud, each character is 
composed of a l-unit start bit, which is always space, followed 
by seven units of information bits; a l-unit parity bit, anda 
l-unit stop bit, is always mark. 


4.5.1.1 Character Structure 


The total character structure consists of 10 units (see Figure 
4-2). At 110 baud, the character structure consists of 11 units, 
the extra unit being assigned to a second stop bit. Characters 
are transmitted with the low order bit first and the eighth bit 
(parity bit) last; i.e., serial, bit-by-bit. 


2910 
Data bits 
1 2 3 4 5 6 7 

Space | | | | | | | | | | | | 
| | | | | | | | | 
Ist | | | | | dt tel | 
ie a | | | | | | | [A] Ss |S | 
| A | | | | | | | [RI TIT 
| R | | | | | | | |r lo]o| 
Pee baa | | | | | | |T | P {P| 
| | | | | | | | [| y | | | 
| | | | | | | | | | | | 
| | | | | | | | | | | | 

Mark | | | | | | | | | | | | 
| 33.3 OR 66.7 MS | 
| <a enn nnn eee >| 
| (300 OR 150 baud) | 
| 100 MS | 
| <a nn nnn rr eee >| 
| (110 baud) | 


Figure 4-2 Character Structure 


4.5.1.2 Modem Connection 


External modems, supplied by either the common carrier or the 
terminal user, are connected to the Carousel 300 internal RS232C 
interface via an extender cable. This 8-foot cable attaches to 
the rear of the cover case and terminates in a standard 25-pin 
male EIA connector. 
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4.6 PERKIN-ELMER MODEL 1100 VDU 

Another device supported by the terminal manager is the 
Perkin-Elmer Model 1100 VDU. It is upward compatible with the 
ASR-33 TTY and the Carousel 50, 30, and 35. 


The basic unit operates on 115 V, 60 Hz. Available options are 
230 V, 50 Hz. 


The hardware for the VDU product family is assembled from basic 
building blocks designed around the Motorola 6800 Micro-Processor 
and the various peripheral and communication interface chips. 


4.6.1 Operational Characteristics 


General specifications for the Model 1100 VDU are: 


e Screen capacity, characters 1,920 
e Characters per line 80 
@e Number of lines 24 
e Tube size (diagonal) 12 inches 
@e Phosphor | P4 
® Displayable characters (upper/lower 128 
case, numbers, punctuation and control) 
@e Character matrix 9 x 12 
e Character generation 7 x 9 
@e Number of scans 12 
@e Refresh rate (noninterlaced) 60 hz (50) 


@e Character code: ASCII (Expanded through multicode sequences) 
@e Keyboard layout: ASCII (Bit pairing) 
@ Repeat key rate: 15 CPS (60 Hz) or 12.5 CPS (50 Hz) 


e Cursor and blinking-reverse video block cursor with blinking 
disable strap. 


e Single key cursor controls: space, backspace, return, line 
feed, tab and back-tab. 


@ Multicode cursor control sequences: up, down, left, right, 
home and direct cursor addressing. 
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Scroll mode (switch selectable): See section 4.6.3.2 


Tab: Tab stops are set every eighth position on initial 
power-on. Tab stops can be set for positions 1 to 80 on all 
lines. 


Transparent mode: All data received is stored in display 
memory and displayed without an initiating control function. 


Audible signal: 2 KHz, 166.7 ms. duration (60 Hz) or 200 ms. 
duration (50 Hz) 


The Model 1100 VDU communications interface features: 


Communication options that are read only during the power-up 
sequence. Changing switch settings while the unit is 
powered-on is not recognized by the terminal until the next 
power-up cycle, or the clear-all key is depressed. 


Asynchronous serial interface conforming to RS232C and CCITT 
V.24. 


Stop bits - switch selectable: one-to-two stop bits. 


Baud rates - switch selectable: 75 - 110 - 200 - 300 - 600 - 
1200 - 1800 - 2400 - 4800 - 9600 baud. 


Transmit/receive mode: half or full duplex, switch 
selectable. 


Switch-selectable parity: odd, even, always marking or always 
spacing. Characters received with parity errors are displayed 
as an alternate dotted rectangle. 


4.6.2 Controls 


The Model 1100 VDU supports the following operator control 
functions: 


Clear all 

Power on/off 

Intensity 

Stop bit select (one/two) 
Baud rate selection 


Mode selection (full/half duplex) 
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@e Parity selection: odd-even-zero-one 
@ Local (A) 
e Auto/LF (A) 


e U/C (A) A = Alternate action switch 


@e Break (M) Momentary switch 


e Scroll enable (A) 

e New line enable (A) 

e Here is (M) 

The Model 1100 VDU supports the following internal straps and 
switches (on the VDU controller board): 


e Disable blinking block cursor 


@e Selection of display mode through switch on PC board: normal 
or reverse video 


@ Multicode character selection by means of 7 straps: default 
condition is ESC 


@e Permanent or switched DTR: if strap is installed, the data 


terminal ready lead to the modem is disabled when terminal is 
in local mode 


4.6.3 Options (All Factory Installed) 

The following options are available with the Model 1100 VDU: 

e Current loop interface (20 ma), active or passive, strap 
selectable (for use with CLCM when using OS/32 Basic Data 
Communications). 

e Here-is ROM with a maximum 32-character here-is message. 

e Auxiliary serial interface 


e Additional RS232C compatible serial interface with baud _ rate 
and stop-bit strapping selection. 


e Current loop option (20 ma), active or passive, for additional 
RS232C interface. 


@e Optional 230 V + 10% 50 Hz. 
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® Optional numeric pad with keys 0: 9) « (period), and , 
(comma). 


e Anti-glare screen 


@ VDU-to-modem cable: connects viSual display unit to RS232C 
compatible modem 


@® Optional underline cursor (block standard). 


4.6.4 Principles of Operation 


The Model 1100 VDU is controlled by data received over the 
communications line and from the keyboard. 


In FDX or HDX mode, data characters received over the line are 
stored in display memory and displayed on the screen. Control 
characters (X'00' - X'1F') and DEL (X'7F') are not stored unless 
the display is in transparent mode or the character is preceded 
by a multicode character. ASCII control characters and data 
initiated at the keyboard are transmitted over the line in HDX or 
FDX mode. In HDX or local mode, the same actions take place when 
the key is depressed as occur when the character is received over 
the line. In FDX mode, the other end device must retransmit 
characters received from the terminal (echoplex) if they are _ to 
affect the display. 


In transparent mode, all control characters stored in memory are 
displayed. 


In normal mode, control characters are. not displayed. Single- 
and multi-character control sequences cause appropriate action to 
take place, except when the display is in transparent mode. 
Local control keys do not transmit data, but cause the 
appropriate actions to take place when depressed. They also 
enable a condition for alternate action type keys. 


4.6.5 Local Control Keys 


Here Is Transmits contents of the answer-back 
ROM, maximum 32-characters. 


Upper Case Only Lower case alphabetic characters are 
converted to upper case, plus’ the 
following punctuation marks are 
converted: @ to ', [to {f, : to *, ] 


to }, and ~ to ™. 


Conversion takes place when a_ character 
enters from the keyboard or line; lower 
case characters already in memory are 
not converted. 
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AUTO/LF 


New Line Enable 


Scroll Enable 


Local 


Repeat. 


Clear All 


Print 


Back Tab 


A CR automatically advances the cursor 
to the first position of the next line. 


Characters beyond position 80 of any 
line continue to be displayed, starting 
at the first position of the next line. 


When LF characters are entered with the 
cursor in line 24, the cursor remains in 
line 24. Line 1 is cleared, and the 
contents of lines 2 through 24 are moved 
to lines 1 through 23. 


Only data entered via the keyboard is 
displayed. Data cannot be received or 
transmitted via the communications line. 


Each character on the keyboard is 
repeated at the rate of 15 characters 
per second (60 Hz) or 12.5 characters 
per second (50 Hz). 


Simulates a powerup sequence: display 
memory is cleared to nulls, cursor is 
moved to home, tabs are set to every 
eighth position, communication options 
are read, and all interfaces 
initialized. 


Initiates a local printout. Data on the 
screen is transmitted to the auxiliary 
serial interface (if present) from the 
current cursor position to the end of 
the screen. 


Moves cursor to the first preceding tab 
stop. If the cursor is to the left of 
the first tab position, the cursor moves 
to column 1. If no tabs are set, the 
back tab moves the cursor to position l. 


4.6.6 Single-Character ASCII Functions 


Line Feed 


Return 
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Moves the cursor down one line, except 
when the VDU is in the scroll enable 
mode and the cursor is in line 24. The 
display rolls up one _ line. If the 
terminal is not in scroll enable mode, 
and the cursor is in line 24, 
the cursor wraps around to line l. 


Moves the cursor to position 1 of the 
current line. If auto/LF is enabled, a 
line feed function is’ performed in 
addition to the return function. 


Space and All Other 
Displayable Characters 


Backspace (BS) 


Tab (HT) 


Break 


Multicode 


Bell 


Form Feed 


Enquiry (ENQ) 


Data Link Escape (DLE) 


Writes a character at the current 
position and moves’ the cursor one 
position to the right. The cursor 
remains at position 80 unless new-line 
enable is selected. 


Moves the cursor to the left one 
position. The cursor remains at 
position 1 for any additional BS unless 
new line enable is selected. Then BS 
wrapS around to position 80 of the 
previous line. The cursor does not move 
beyond Home (first character, first 
line). 


Moves the cursor to the next tab 
position. If new line enable is not set 
and the cursor is past the last tab 
position, tab moves’ the cursor to 
position 80. If new line enable is 
selected and the cursor is past the last 
tab position, tab moves the cursor. to 
the first tab position on the next line. 
If there are no tabs set, tab moves the 
cursor to position 80; if new line 
enable is also set, the cursor moves to 
line 24. 


Causes the communications line to go to 
a space (break) for as long as the key 
is depressed. 


Initiates a special function sequence 
(multicode character defined by straps). 
Default is ESC. 


Causes the audible alarm to sound for 
166.7 ms (60 Hz) or 200 ms (50 Hz). 


If scroll is enabled, form feed has’ the 
same effect as line feed. If scroll is 
not enabled, form feed erases the screen 
and moves the cursor to home. 


Causes the contents of the ansSwer-back 
ROM to be transmitted. 


Ignored unless followed by STX, in which 
case it causes the display to enter 
transparent mode. In transparent mode, 
all characters including control are 
stored in memory and displayed. New 
line is enabled; scroll is disabled. If 
DLE is received in transparent mode, the 
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next character is examined. If ETX is 
received, the display is returned to 
normal mode; otherwise a received 
character is stored and displayed. 


4.6.7 Multicode Sequences 


Multicode-A 


Multicode-B 


Multicode-C 


Multicode-D 


Multicode-H 


Multicode-X 
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Cursor Up (A) 


Moves the cursor up one line. If in 
line 1, the cursor wraps around to line 
24 


Cursor Down (y) 


Moves the cursor down one line. If in 
line 24, the cursor wraps around to line 
1 


Cursor Right (—») 


Moves the cursor one position to the 
right. When the cursor is moved beyond 
position 80, the cursor wraps around to 
position 1 of the following line if the 
terminal is in new-line-enable mode. If 
new line is not enabled, the cursor 
remains in column 80 (line 1 follows 
line 24). 


Cursor Left «—) 


Moves the cursor one position to the 
left. When the cursor is moved beyond 
position 1, the cursor wraps around to 
position 80 on the previous line if the 
terminal is in new-line-enable mode. If 
new line is not enabled, the cursor 
remains in column l. 


Cursor Home (BH) 


Moves the cursor to position 1, line 1 
(home) 


Direct Cursor Address - Line Position 
Moves the cursor vertically to any line 


as specified by the character following 
X, as shown in Table 4-4 


Multicode-Y 


Multicode-Z 


Multicode-l 


Multicode-2 


Multicode-3 


Multicode-K 


Multicode-I 


Multicode-J 


Direct Cursor Address - Character 
Position 


Moves the cursor horizontally to any 
position on a line. The character 
following Y specifies the horizontal 
character position, as specified in 
Table 4-4. 


Read Cursor Address 

Causes the terminal to transmit the line 
and character position of the cursor, as 
specified in Table 4-4 

Set Tab 

A tab stop is set at the cursor 
position. Tab stops can be set in any 
of the 24 lines of the display and are 
effective for all lines. 

Clear Tab 


The tab stop at the cursor location is 
cleared. 


Clear All Tabs 
All tab stops are cleared. 
Clear All 


Clears the display memory to nulls. All 
tab stops are cleared. 


Clear Line 

Clears line (reset to nulls) starting 
with the present cursor position to the 
end of line 

Clear Display 

Clears the display (reset to nulls). 
Except for tab stops, the entire display 


is cleared from the present cursor 
location to the end of the page. 
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TABLE 4-4 CURSOR ADDRESSING 


=a il 
“NS it 
HD lANNAMNWOKRDHOANMNANUOR DHOCAAMNAMNUORAHDOAHNANMANUONRADS 
SNe SS ee YEN AOE LOUIE SEO SOOO NEO ORO Ee Ra rs Er Sos eno 
wo il 
il 
= owe cue i nee emmeme emeeee ae Cm gee eee me ees eres emmee omemme em we comes mms eee een cee ee mes cee eee ees ee ee ee wee ee ee ee wes em cme cee ees wenn ee oe 
“| 
MiODQMUAQAHHROANMNAMNUWOPAAKCMUANDWROHAMAWMNOFNR ADA CGCMVUVANEA 
1 il << << ct td ELN LN LN LN LN LN LN NW LNW LN LN WN LN WH OO OW 1 OW OOO 
il 
me mee oe i mes eee eee comes CemEe Gees eT Gums eee Gee Cees om ame came Ce eee gees GOES CREE Gere cee eee cme ees we eee eee ewes Genes Gee eee eee cee ee ee gees ee oes oe 
il 
i 
4 
et tee eo ee Or 2 Eee ratte tet Ne Oe ONO a Our at Eee 
eG ii 
it 
= a Gate i a A SS EES ago EE EE ee ee Re Ee eS a See ee ee ee ee ee ee ee Gee ee eee eee ee 
a os oo! rf] ess eee eee eee ee eee cee eee cee wo ce wr ee eee ee eee cee eee cee ese eee eee eee coe Ce ese eee eee eee ce eo eee Ge eee ew mee eee ew eo 
i 
a il 
Nl 
HD il DANMNAMNORM DHOHAMAMNORDAHOANMANUONR AHO 
NG Sieh Aen GEE U hr N OY OWEN CN Oy EN Ow CNM OO Ngo Soa oS n ee 
KH i 
HO fi 
it 
— —— anne tt ree cee mee Gene CD ee eS OED Gees cee Gee eee GEES ee Ge cee Sees cme ewe Ce qe wees cree Gee OED eee CED qe cme ewes eee emmee Cte eee come eee eee oes eee 
oH 
DAUIOANMNTNORAOADKAMVADMMOAHNMAMNORAOADRMVANRRCHAMANONM 
aD OLN GEV OE OS SUELO SE OES CY COC) FIELD NN LOC Co CUT A Se ve oe 
—2 = eames il es SS eS SE EE eS eS EE eee Gee eS ED REED GS GEE GREED CES eeemS Ce SEED ee GS eee GEES GEE eS GED ee eee Cee cuee mem GmeED Gees Gmee emmme omens eee ome 
} 
HK ia~ 
ri il Ay 
4 } Wot HU OH B= HARK $5 Ff PRC AN MANOR OD ec av fLAn@WgTWemMuUaDWARY 
cil 


4.7 ENCODED ERROR MESSAGES 


I/O 


control of the TTY/VDU terminal 


Table 4-5 lists these messages. 


an 


of 


the 


under 


Encoded messages are displayed indicating the status 
occurring 


operation 
manager. 


4-19 
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TABLE 4-5 ENCODED ERRORS AND DEFINITIONS FOR TELETYPE 
(TTY) TERMINAL MANAGER 


on ees Ee et ET ee ONE Git Shs ne Ge Ge aim Gee Game GY Gen me GD Gee Oe GE ae Gee One GP Ge am Ome eee oe eee OY Om ane a GSS Ge Ne ame Ge One Ot Oth Ges OEE tie they Ge Gate I ON) es Ges ce Gl Ge inh 


| | 

(HEX) | MEANING | 

0000 | No errors | 

| | 

8402 | Line delete caused termination during read | 

8203 | Break detected during write | 

8204 | Break detected during read | 

8205 | Terminated by data error (see parity bits) | 

| | | 

8208 | Framing or stop-bit error | 

8409 Reverse channel error | 

200A Lost carrier on read | 

200B | Lost clear-to-send on write | 

200C | Data set not ready | 

840D | Device unavailable; adapter not present | 

820E | Character overflow | 

840F | Ring status detected during data transfer | 

8410 | Busy and/or done bits in chained buffers | 

| bad; may indicate priority too low | 

8411 | Number of commands executed greater than | 

} 255 | 

| | 

8412 | Task gueue full, invalid or nonexistent | 

8413 | Buffer-management-routine error; may indi- | 

| cate priority too low | 

8282 | Timeout | 

8281 | Halt I/O request aborted I/O | 

8418 | Invalid command or modifier | 

| | 

8419 | Memory fault in referencing data | 

| | 

841A | Memory fault in referencing buffer | 

| | 

811B | Logical unit illegal | 

| | 

841C |} Illogical device status | 

| 

A01D | Power failure | 
| 

841E | Illegal software condition : 
| 

841F | Illegal translation table | 
| 

8225 | Timeout during connect sequence | 
| 

8426 | ESC, R not received on RQS | 


awe ee ee ee ee ot OEE ey Gee ee ee gee Oe Ge GE ee ot Gre a aoe Ene Gee Gee Get Gee ome Gre Gee Gee GD Gom ce Gee Gn OE GE Gt ins OEE ie Ot Ge th Gt Gee cee ce Os Coe oes dee Ge) om oe ee dee 
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The first byte of each status code listed in Table 4-5 refers to 
the device independent status of the error. These codes are 
defined as follows: 


CODE 


co 


AC 


90 


88 


84 


81 


82 


20 
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DEFINITION 


Illegal function 


Device unavailable; sign off user. If 
switched line, reissue call. 


End of medium 


End of file 


Unrecoverable error; report to operator 


Illegal or unassigned lu 


Parity or recoverable error; reissue the call 


Device unavailable or parity error sent to 
recovery routine 


CHAPTER 5 
MODELS 1200/1250/1251 EDITING VIDEO DISPLAY UNIT (VDU) 
TERMINAL MANAGERS 


5.1 INTRODUCTION 


This chapter describes the functions of the Models 1200/1250/1251 
Editing VDU Terminal Manager. This terminal manager operates 
within OS/32 (RO6 software release and higher). The Models 
1200/1250/1251 terminal managers provide the user with the full 
range of editing features and programmable operations that are 
available with these models. These features include the 
multidrop and light pen capabilities of the Models 1250/1251. 


User programs can communicate with these VDUsS via supervisor call 
1 (svc 1). ‘The terminal manager supports local and_ remote 
point-to-point communications as well as standard utility 
programs. 


Because the Models 1200/1250/1251 terminal managers support all 
features of INITMASY, the terminal manager can replace INITMASY 
when Models 1200 or 1250/1251 VDUs are being added to existing 
teletype (TTY) configured systems. 


5.2 FUNCTIONAL DESCRIPTION 


5.2.1 Device Assignment 


The Models 1200/1250/1251 Editing VDUs can be assigned to a_ user 
task (u-task) logical unit (lu) by one of two methods: 


1. The operator ASSIGN command, or 


2. The SVC 7 assign function. 


Refer to the OS/32 Supervisor Call (SVC) Reference Manual and the 
OS/32 Basic Data Communications Reference Manual for detailed 
assignment procedures. 


To assign the Models 1250/1251 VDUs to an lu in ae multidrop 
environment, use the GENERATE command or macro in the user 
program. The GENERATE command or macro generates system 
structures associated with the terminal name; the ELIMINATE 
command or macro is used to eliminate them. 
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5.2.1.1 GENERATE Command 


The GENERATE command builds system structures within system space 
for the Models 1250/1251 vbDUs. 


Format: 


GENERATE tn,cnum 


Parameters: 


tn 


cnum 


Example: 


LOAD EGU. TSK 
TA EGU 


is a file descriptor (fd) s =. ing the name 
of the terminal. This standar d, defined by 
the designer/operator, has She format of 
voln:filename.ext, where voln is the sysgened 
device mnemonic of the communications line, 
and filename.ext is the name of the terminal. 


is a decimal number from 0 through 127 (except 
for codes listed in Appendix B) specifying the 
terminal address that corresponds to a 
poll/select address for the terminal. A 
system operator obtains a value for cnum from 
the system designer. 


ST ,COM=CON: ,LOG=PRT2: , ERR=GENERR: EGU 
GENERATE BSCO:DISPLAY.001,0 
GENERATE BSCO:DISPLAY.002,1 
GENERATE BSC1:DISPLAY.C01,2 
GENERATE BSC1: PRINTER.002 ,3 


END 


5.2.1.2 GENERATE Macro 


The GENERATE macro, 


issued from within a task, builds’ system 


structures within system space for the Models 1250/1251 vbDUs. 


5-2 
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Format: 


| 
OPERATION | OPERAND 


Parameters: 


xadr 


XPCB= 


FD= 


CNUM= 
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GENERATE 


absexp 
, CNUM= 


| 

| 

| 

| 

ieee 

| ,FD='fd' 
| 

| 

| 

| reg 
| 


is the symbolic or indexed address of a 
previously constructed parameter control block 
(PCB). If this parameter is omitted, the 
parameter control block is automatically 
built, and its address is placed in register 
14. 


xadrx is the symbolic or indexed address of an 
extended parameter control block. If this 
parameter and the xadr parameter are omitted, 
the extended PCB is automatically built and 
linked to the previously constructed PCB. 


(reg) is a register expression specifying a 
decimal value from 0 through 15 that indicates 
the register containing the address of an 
extended PCB. 


‘fd' is the unpacked file descriptor of the 
terminal for which the PCB is being generated. 
This fd corresponds to the terminal name (tn) 
in the GENERATE command. If this parameter is 
omitted, the fd must have been previously 
specified in the FMPCB macro. 


absexp is an absolute byte expression 
specifying the decimal value from 0 through 
127 that designates the terminal poll/select 
address. If this parameter is omitted, it 
must have been previously specified in the 
XFMPCB macro. See Section 5.2.1.3. 


Functional Details: 


Before execution of the GENERATE macro, the PCB must contain a 
value for FD, and the extended portion of this PCB built by the 
XFMPCB macro must contain a value for CNUM. If the PCB does not 
contain these values, they must be specified with the GENERATE 
macro. 


Example: 
GENERATE FM. PCB, CNUM= (R2) 
5.2.1.3 XFMPCB Macro 


The XFMPCB macro constructs an extended portion for the file 
Management PCB. 


Format: 
| | 
NAME | OPERATION | OPERAND 
symbol {| XFMPCB | absexp 
| | _,CNUM= 
| | (reg) 
| | 
Parameter: 
CNUM= absexp is an absolute byte expression 


specifying the decimal value from 0 through 
255 that corresponds to the ASCII character 
code for the terminal poll/select address. If 
this parameter is omitted, it must have been 
previously specified in the GENERATE macro. 


(reg) is a register expression specifying a 
decimal value from 0 through 15 that indicates 
the register containing the poll/select 
address. 


Functional Details: 


If symbol is specified, it becomes the symbolic address. Whether 
or not symbol is specified, the macro places the extended PCB 
address into register 14. 
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The extended PCB must contain a value for CNUM before the 
GENERATE macro can be expanded. If omitted from the XFMPCB 
macro, CNUM must be included with the GENERATE macro. 


5.2.1.4 ELIMINATE Command 
The ELIMINATE command eliminates system structures from system 
Space that were previously built for the Models 1250/1251 VDUs. 


Formats: 


ELIMINATE tn 


Parameter: 
tn is an fd specifying the name of the terminal 
to be eliminated. See the GENERATE command 
for a detailed description of this parameter. 
Example: 


LOAD EGU. TAK 

TA EGU 

ST ,LOG=PRT2: , ERR=GENERR. EGU, COM=CON: 
BLIMINATE BSC2:DISPLAY.001 

END 


5.2.1.5 ELIMINATE Macro 
The ELIMINATE macro eliminates system structures within system 
space previously generated for the Models 1250/1251 VDUs. 


Formats: 


OPERATION 


ELIMINATE 


OPERAND 


n 
MM 
& 
o 
ra 
tal 
» 
Qu 
a! 
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Operands: 


xadr is the symbolic or indexed address of a 
previously constructed PCB. If this parameter 
is omitted, the PCB is automatically built, 
and its address is placed in register 14. 


FD= 'fd' is the unpacked file descriptor of the 
terminal for which the PCB is being generated. 
This fd corresponds to the terminal name (tn) 
in the GENERATE command. If this parameter is 
omitted, the fd must have been previously 
specified in the FMPCB macro. 


Functional Details: 


Before execution of the ELIMINATE macro, the PCB must contain a 
value for FD, and the logical unit (lu) to which the file 
descriptor is assigned must be closed. 


Example: 


ELIMINATE FM.PCB1,FD-MDCB.DISPLAY.002 


5.2.2 SVC 1 Interface 


SVC 1 is used to initiate I/O for both local and remote devices. 
See the OS/32 Supervisor Call (SVC) Reference Manual for a 
detailed description of the SVC 1 parameter block. 


5.2.3 SVC 1 Extended Options 


The extended options field of the SVC 1 parameter block specifies 
to the 0S/32 data communications subsystem the I/O functions’ to 
be supported for the Models 1200/1250/1251 VDUs. When this field 
is used, bit 7 of the SVC 1 function code and bit 6 of the task 
option word located in the task control block (TCB) are set to l. 


Figure 5-1 illustrates the fullword format of the extended 
options field of the SVC 1 parameter block. 


Function Extended 
modifiers functions 


2911 


= = a > a a om ap GD om a> oe o> am oe oF Ge a @ @ © 8 oe oe a om ae ao am @ oF a a @& ow @& @ oe & & ow om ow oF ce @ © af we aw ee we ow @ @ on 


Figure 5-1 Extended Options Fullword Format 
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Bits 0 through 15 are for general use in both local and remote 
communications. Bits 16 through 25 are used as function 
modifiers, while bits’ 26 through 31 can be used to specify up to 
64 device dependent I/O functions, 41 of which are used in Models 
1200 and 1250/1251 communications. Available extended functions 
and function modifiers for the SVC 1 extended options fullword 
are listed and described in Table 5-l. 


TABLE 5-1 SVC 1 FUNCTION/FUNCTION MODIFIER OPTIONS 


me Geen GES ER Ge BF OOn ERK OE GY Et GY GEH SEW Gas Gem Gu GEN GEO Gy Gee Gen ome eRe me ET GET CPG Gm Gum GET Ome ET CEE GEE GEN GEY One Gre GE EE One GEE Ger Gms GE Grn OEE Ben OY CoD COE GEe CRU Gen OY GET ome eG em Gen OE eee om 


BIT | | 
SETTING | | 
(HEX) |. OPTION | MEANING 
Y¥'8000 0000' | Connect (CON) | Terminal manager answers a tele- 
| | phone ring on a dial-in line 
| | during a read or write line 
| | initialization sequence. 
¥'4000 0000' | Disconnect | Terminal manager disconnects 
(DCT) from_a_ switched line following 
final data transfer. 
Y'0000 0000' | Image (IMG) | Data being transmitted is in im- 
| | age mode and is not formatted. 
Y¥'2000 0000' | Format (FMT) | Terminal manager performs normal 
| | record buffering, inserts or de- 
| | letes line control characters, 
| | and recognizes appropriate data 
| | format control characters on 
| | transmitted data. 
¥'0080 0000' | Vertical | Requests VFC option for an ASCII 
| | forms control | I/O operation. 
| (VEC) 
Y¥'0000 8000" | Nontermina- | Read will terminate only on de- 
| tion on CR | tection of end of text. 
| (NTC) | 
Y¥'0000 4000' | Enable upper- | Translation of lower to upper 
| case only | case is enabled. 
| (EUO) | 
Y'0000 2000' | Clear screen | Clears screen before I/O 
| (CLS) | 
Y¥'0000 1000° {| Unlock key- | Unlocks the keyboard after I/0 


| board (UKB) | 
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TABLE 5-1 SVC 1 FUNCTION/FUNCTION MODIFIER OPTIONS (Continued) 


See ent Oe Oe ee) SE et eee coos ae, eee Gee eee mee Gen Ge Glin ate Ome Gam Eee ek Ge Ok SE Gen OSs Gee Ge ae ae ee ee ee Ge ee Oe ee ee ee ee Oe es oe Oe On OF EY ee te ee ee ee Re ee a eee ey OE Oe oe Om one 


BIT | | 
SETTING | | 
(HEX) | OPTION | MEANING 
Y¥'0000 0800' | Lock Revboard | Locks the keyboard after 1/0 
| (LKB) | 
Y'0000 0400' | Write blink- | Writes blinking characters 
| ing charac- | 
| ters (WBL) | 
Y¥'0000 0200' Write protec- Writes protected characters 
ted charac- 
| ters (WPC) | 
Y¥'0000 0100' | Write reverse | Writes reverse video characters 
| characters | 
| (WRV) 
Y'0000 0080' | Write low- | Writes low-intensity characters 
| intensity | 
| characters | 
| (WLI) | 
Y¥'0000 0000' | Conversa- | Executes the read/write as con- 
| tional mode | versational 
| (CNV) 

‘0000 0001' | Request to | Issues the RQS sequence from a 
| send (RQS) | terminal and places an attention 
| | identifier character (AID) in 
| | the user buffer, usually follow- 
| | ed by read immediate 

¥'0000 0002' | Read | Reads sequence used in conjunc- 
| immediate | tion with the RQS sequence to 
| unprotected {| read unprotected fields from a 
{ (RIU) | formatted screen 

‘0000 0003' | Read | Reads sequence used in conjunc- 
| immediate | tion with RQS sequence to read 
| modified | modified data fields froma for- 
| (RIM) {| matted screen only 

Y'0000 0004' Read Reads sequence used in conjunc- 


| | 

| immediate all | tion with the RQS to read an en- 
| (RIA) | tire screen. Data transfer is 

| | based on setting of full/partial 
| | screen mode. 
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TABLE 5-1 SVC 1 FUNCTION/FUNCTION MODIFIER OPTIONS (Continued) 


AE GD GNP GRR GE Ger Set ae ee Get GF En Ge Gey GRE SE Ey SFE Gee Eee GON SES OH Ge OF GET Eee Gee OR SET Ge Ort EET eee emt Ot gee Gee Ot Cm EE OE OST em Gee Ee ome ee Om ame Orr Om ome Gt OE ee GN Set a om ae ot ew on 


BIT | | 
SETTING | 
(HEX) | OPTION | MEANING 
¥'0000 0005' | Send | Reads unprotected data fields in 
| immediate | send immediate mode; i.e., when- 
| unprotected | ever the send key is pressed 
| (SIU) | 
Y'0000 0006' | Send | Reads modified data fields from 
| immediate | a formatted screen whenever the 
| modified | send key is pressed 
|. (SIM) | 
Y¥'0000 0007' | Send | Reads the entire screen of data 
| immediate all | whenever the send key is pressed 
| (SIA) 
Y¥'0000 0008' | Write buffer | Indicates the call is a write 
| edit (WBE) | in edit mode; i.e., depending on 
which function modifier is set, 
WBE can write blinking charact- 
| | ers, protected characters, etc. 
Y'0000 0009' Read cursor Places cursor address in the | 


ceived from Perkin-Elmer Models 
1200 or 1250/1251 VDUs 
Y'0000 OOOA' | Read options | Reads two option bytes through 
| (ROP) | Models 1200 or 1250/1251 VbDUs 
| | into the user buffer 


| 

address (RCA) | user buffer exactly as it is re- 
| 
| 


Y¥'0000 OOOB' | Read status | Terminal immediately transmits 
| immediate | status byte to host 
| (RST) | 

Y¥'0000 OO0OC' | Read status | Reads status byte through Models 
| when ready | 1200 or 1250/1251 VDUs only when 
| (RSR) | print or insert/delete is com- 
| | pleted 


| Clears unprotected areas of the 
| (CLS) | screen only 
Y¥'0000 OOOE' | Clear memory | Clears all memory including pro- 
| (CLM) | tected area 
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TABLE 5-1 SVC 


1 FUNCTION/FUNCTION MODIFIER OPTIONS (Continued) 


ee a a se ee ee ee ee 


BIT 
(HEX 
Yy'0000 


) 
OOOF' 


Enter 
transparent 
mode (ETM) 


Enter normal 


mode (ENM) 


All subsequent characters, in- 
cluding control codes, are 
stored in memory and displayed. 
No control action takes place. 

A new line is enabled and scroll 
is disabled, regardless of the 
local control key setting. 


Exits from transparent mode. 
Control characters are neither 
stored nor displayed. 


(HME) 


oe Oe eee ee re Se en om es ee es et OE ee Ge ee Oe See Oe Gy ES Ge Ge Gee See Gee Gee OE Gee Om Gee Bee Gh HO OT Bee Ene TY Eee © GOR Gee Gee en Gee Ge Bie te Gee Se Oe Ge ee ten Cow ee 


Set cursor 
position 
(SCP) 


Cursor position line hexadecimal 
numbers 00 through 17 and column 
hexadecimal numbers 00 through 
4F are provided in the user 
buffer. 


om Gm ame Ot Ot CEH Bes ERE Gt Set Gn See Cot Gee WY Ren Oe oe oes ee ee ee mt ee oe wes om fee 2 ee OF) Oe ee ee oe ow Om ee ee ee Ee ee ee oe Se ee ne fen Ot ee Gee SD EE Be Gee ee Ce ee et oe ee 


(CLF) 


Clears the current field to 
which the cursor is pointing 


(STS) 


Sets tab stop positions in the 
user buffer. Tabs are effective 
for all lines. 


EP one Cnt rn ame GR GPT Gre ORk SEE OE BET GF Gen Ge GFE Wer abe Gm Gee GE an Om Gee Oe ee oe SP OT Oe Ow Em om Eee Set om Gee ee See Ee GN Ot Ger Ge Ue Ome Cen Gen Oe OE et Gh em Ge Om em Ee PO ee ee ot ee oe 


Clear all 
tab stops 
(CAT) 


ow en © OF OF om Cer a ae ee amt mF ane am ome ee ts Gwe Ger OD Che Ot EY ON Om Em Ow Oe OT ONE Oey Gen GE On OST Oar Ge te GH Om GN ET Gm Bre OS GN OE Oe ED Om ms OE OH Oe Ee Oe ee OD Gm One foe Oi OF em 


Modify data 


communications 


default 
extended 
options (MOD) 


Modifies the encoded value in 
bits 12-15 of the data communi- 
cations extended device code 
DCB.XDCD 


Unlock 
(UKB) 


(LKB) 


y'0000 


Clear 
modified data 
tags (CDT) 


Clears modified data tags only 


48-047 FOO RO1 


TABLE 5-1 SVC 


1 FUNCTION/FUNCTION MODIFIER OPTIONS (Continued) 


BIT | 


(HEX) | 


ee eee ee eee ee ee es ee a corm eet ee SR ee EE EY ee TT SEF GEO Gre Gre Gee EE Gn Gree SED Gem Gere GES ES me OEE Gee SEH Se OS OEE SOR Gane EF Oe EE OE Ee Ee ee ae Oe re eRe eee One UEP See See Er Ome oem eee om ome ome oe aoe 
See ee Gare ee Gee ee ee Se See Te See See Ae SE SS See Se SSS St Se SO See Se Se Se Sah es SNS SE SE SS Set SS SS SE SS SOS Sen SEN Sa GN SEN GES Gre GS GS ENS GaP Gwe Se EP GE GD Gu Gee Ga” HEP Gee WE one Gen Grn aoe 


Stop print 
option (SPO) 


Stops printing after printout 
currently in progress is 
finished 


et Ge Gee Ge CE CET GED Gre ee ey Gey Gee Ge gE ee ET SON GRE One SET GRA OOS Ot OE CF EE Ole: Gen EER GET GR. OF Gem Ble Gee ERE Gee Gme Gen Gee Gee GER Ger GE ENO Ee GT GER OEY EEN OT GE Om GRY Gre En eee GF em eee oe ow er oor 


Print screen 
from home 
(PHM) 


Print screen 
from cursor 
(PCR) 


Prints screen from current cu 
sor position to the end of 
screen 


I- 


Activates the form feed control 


Simulprint 
form feed 
control (PFF) 


for the print page 


Simultaneously outputs charac- 


Continuous 
simulprint 
(PCO) 


ters to the Models 1200 or 
1250/1251 VDUs and the remote 
printer 


(PGP) 


Directs Models 1200/1250/1251 
VDU terminal managers to send 
RQS sequence and wait for the 


user to press the VDU function 


keys 


Y'0000 0020' 


Write edit 
with 
attribute 
character 
generated 
(WAG) 


Sends any character with pari 


ty 


bit set as an attribute charac- 


ter to Models 1200 or 1250/12 
VDUs following an ESC! genera 
by the terminal manager 


51 
ted 


Read all with 
attribute 
character 
truncated 
(RAT) 


Optimizes the data read from 
Models 1200 or 1250/1251 VDUs 
during read all by disregardi 


ESC! 


ng 


ow Cee OE Om Onn Gt OFT GT EF OD CHE OW CFO Gey Elm OR GFP GR EET Get Gee GaR Ee CFT OEE GOn EE GT OT G58 OFF Gm Gee GP OS GF GFR ENE OW Cm Gee EY Blt Om GET GET GHD Ere EF OT OF! GTS On Oe OH = OF OF es Oe Ow oF FY Om oF 


¥'0000 0022' 
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Send all with 
attribute 
character 
truncated 
(SAT) 


Optimizes the data read from 
Models 1200 or 1250/1251 VDUs 
during send all by disregardi 
ESC! 


ng 


TABLE 5-1 SVC 1 FUNCTION/FUNCTION MODIFIER OPTIONS (Continued) 


BIT | | 
SETTING | | 
(HEX) | OPTION | MEANING 
Y'0000 0023' | Send key | Overrides the previous send key 
| override | pressed during RQS. This 
| (SKO) | applies to only one data trans- 
| | mission. 
Y'0000 0024' | Write status | Writes a maximum of 30 charac- 
| line user | ters to the 30-byte user area of 
| area (WSL) | the Models 1250/1251 status line 
Y¥'0000 0025' | Send status {| Reads a 33-byte user area of the 
| line user | status line whenever the Models 
| area (SSL) | 1250/1251 SEND key is pressed 
Y'0000 0026' | Write user- | Writes a user-supplied terminal 
| supplied | configuration to Models 1250/ 
| terminal {| 1251 VDU EAROMS (permanent) 
| configuration | 
| to EAROM | 
| (WUP) | 
Y¥'0000 0027' | Write user- | Writes a user-Supplied terminal 
7 | supplied | configuration to Models 1250/ 
| terminal | 1251 VDU RAMs (temporary) 
| configuration | 


to RAM (WUT) 
Y'0000 0028' | Read terminal | Reads 902 configuration bytes 
| configuration | from Models 1250/1251 VDUs into 
| (RTC) | the user buffer 


NOTE 


Extended option bits 3 through 7, 9 
through 15, and 25 are reserved and must 
be set to 0. 


SVC 1 extended functions are mutually exclusive; however, an I/O 
with multiple requests or operations can be performed. The 
function modifiers are used to expand a function's capability. 
For example, the write edit function can be expanded to write 
blinking, write protected, write reverse video, or write 
low-intensity by a function modifier. However, not all function 
modifiers apply to each extended function. Table 5-2 lists the 
possible function/function modifier combinations. 
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the 


function 
indicates 


invalid 


A blank box 


a valid function function/modifier 
an 


indicates 


x 
function/modifier combination. 


indicates 
function modifier does not apply to that particular function 


An asterisk 
combination. 
Situation. 


* 


5.3 USING THE MODELS 1200/1250/1251 VDU TERMINAL MANAGERS 


Programmers can encounter various levels of complexity in using 
the Models 1200/1250/1251 VDU terminal managers. If the Models 
1200 and 1250/1251 VDUs are used as_ replacements for fMTTY 
terminals in an interactive environment, the terminal manager is 
interfaced with the standard Basic Data Communications MTTY/VDU 
Terminal Manager. However, if the terminals are used to take 
advantage of all their features, the programmer should be aware 
of both the hardware features and the logical interface 
procedures used to access the terminal manager for each model. 


The following sections describe the hardware capabilities, the 
operation modes, software and hardware environment requirements, 


and general system generation (sysgen) procedures for the Models 
1200 and 1250/1251 vDUs. 


5.3.1 Models 1250/1251 Terminal Configuration 


The Models 1250/1251 VDUs must be configured through a_ terminal 
configuration procedure to operate ina multi-terminal monitor 
(MTM) or integrated transaction controller (ITC) environment. 
Configuration can be performed in two ways: 


l. at the terminal end (user configuration), and 


2. at the host end (downline load configuration). 


If the Models 1250/1251 VDUs are configured at the terminal end, 
the user selects and enters desired options from sets of 
functions called menus. If the Models 1250/1251 VDUs are 
configured at the host end, the host performs downline loading by 
sending the appropriate multicode sequences to the terminal. 


For detailed information concerning user and downline load 
configurations, refer to the Models 1250/1251 Visual Display 
Units (VDU) Terminal Configuration User Guide and the Models 
1250/1251 Visual Display Units (VDU) User's Manual. 


5.3.2 Terminal Features and Special Character Format 


The following sections describe special character sequences 
interpreted by the Models 1200 and 1250/1251. Multicode, 
attribute, and certain line character sequences can also be 
included within the user buffer to activate specific terminal 
features. The description of the input AID character, status 
bytes, and option bytes can be used to interpret the special 
sequences received from the terminals through terminal manager 
extended functions. 
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5.3.2.1 Multicode Sequence 


Multicode sequences are used to implement such terminal 
operations as cursor movement, lock-out, setting tabs, field or 
screen clearing, editing and setting attribute bytes and print 
options. 


The standard method for executing multicode operations from the 
host computer involves transmission of a multicode character to 
the terminal, immediately followed by a character designated 
unique to the function being performed. See Table 5-3 for a list 
of some common multicode sequence characters. For example, by 
transmitting the sequence ESC A (where ESC has been defined as 
the multicode character), the host commands the terminal to move 
the cursor up one line. Most multicode sequences on the Model 
1200 can also be initiated from the keyboard by depressing the 
multicode key and then depressing the designated character key. 


The ESC character is normally used as the multicode character for 
Models 1200/1250/1251 terminal configurations. However, the 
Models 1250/1251 terminal configuration allows the programmer to 
designate any ASCII character as the multicode character in the 
event that the ESC character is dedicated to another system 
function. In order to store a multicode character as itself, it 


must be entered through the keyboard or transmitted over the 
communications line twice. 


TABLE 5-3 MULTICODE SEQUENCES 


| HEX | ASCII | | 
| CODE | DISPLAY | DESCRIPTION | 
| SESS SSS SS SB SESS SSee SSB TSS SSS SSS S STS SSS SS SSS | 
| 21 |! | Set attribute | 
| 28 | ( | Lock keyboard | 
| 29 | ) | Unlock keyboard [ 
| 31 } 1 | Set tab | 
| 32 | 2 | Clear tab | 
| 33 | 3 | Clear all tabs | 
| 3B | 3 | Set print options | 
| 3c | < | Send key override [ 
| 41 | A | Cursor up | 
| 42 | B | Cursor down | 
| 43 |} c | Cursor right | 
| 44 | D | Cursor left | 
| 45 | E | Set full screen { 
| 46 | F | Set partial screen | 
| 47 | G | Set conversational [ 
| 48 | H | Home cursor | 
| 49 | I | Clear line/field | 
| 4A | J | Clear unprotected* | 
| 4B | K | Clear display memory* | 
| 4c | L | Insert line* | 
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TABLE 5-3 MULTICODE SEQUENCES (Continued) 


| HEX { ASCII | | 
| CODE | DISPLAY | DESCRIPTION | 
[eecseernsnesesee serene e sess sess sseesssess | 
| 4D | M | Delete line* | 
| 4E | N | Insert character* | 
| 4F 1 0 | Delete character* | 
| 50 | P | Poll/select | 
| 51 1 Q | Reset modified data tags | 
| 52 | R | Request to send | 
| 53 | s | Set buffer address | 
| 54 | T |} Insert cursor | 
| 58 {| xX | Set cursor pos-line [ 
| 59 | Y | Set cursor pos-character | 


* These multicode sequences require time 
delays in the transmission stream. The 
user should have NULL fill characters 
following the multicode sequence in the 
transmission buffer. For further 
information, refer to the Model 1200 and 
Models 1250/1251 User Manuals. 


5.3.2.2 Attribute Characters 


Attribute characters are used to define the start of a field and 
the mode in which the field is displayed. The end of a field is 
defined by a second attribute entry that defines the start of the 
next field. 


Programmers can send attribute characters to the VDU by sending 
ESC ! (Hex 1B, 21) followed by the attribute character, and 
issuing a write edit with the attribute character generated. 
Also, programmers can issue a write-edit function call with the 
function modifiers such as write blink, write protect, write 
reverse video, and write low intensity. Figure 5-2 shows the 
format of the attribute character. 


These Models 1200/1250/1251 commands are specified by an escape 


character (Hex 1B) plus the ASCII values shown in the column to 
the left of each command. See Appendix B for ASCII codes. 
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| | | IND {Iv |LI | | | 


Figure 5-2 Attribute Characters 


BIT MEANING 


0 Parity 
1 O=normal field 


l=blinking field 


2 Modified data tag identifiers (modified field 
for read/send modified transmissions) 


O=not modified 
l=modified 


3 O=display field 
l=nondisplay field (security) 


4 O=normal video 
l=inverse video 


5 O=normal intensity 
l=low intensity 


6-7 00=alphanumeric 
Ol=numeric entry only (1-9., + -$) 
10=protected field 
ll=graphics (bits 1-5=graphic characters) 


5.3.2.3 Line Drawing Characters 


User programs can cause the terminal to enter the graphic mode by 
sending a shift out character (SO, Hex 'OE'). The characters 
following are then interpreted as line drawing characters. Refer 
to Table 5-4. User programs can exit the graphic mode by sending 
a shift in character (SI, Hex 'OF'). 


User programs can also cause the terminal to enter the graphic 
mode by sending an attribute character (with bits 6 and 7 set to 
one) to be interpreted as a line drawing character. The graphic 
mode is exited immediately after outputting this attribute 
character. 
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TABLE 5-4 LINE DRAWING CHARACTERS 


| BITS | | BIT] = X | BIT1 = x | 
|--------- | HEX | BIT2 = X | BIT2 = xX | 
| 45 67 | VALUE | BIT3 = 0 | BIT3 = 1 | 
10000] 0 1}@fs}- |}PITe | 
| | | | | | | 
}ooo1 {1 | A | r |TQt Ff 
| | | | | | | 
a ee ae Naat a ot 
1}oo01143 [E-CO> 2 Sh a A 
| | | | | | | 
101001] 4 IDI +r ITl e | 
| | | | | | | 
}olol1l{s fE?T_ ocelud ad 
| | | | | | | 
|}o1101 6 IFi r ivl dt 
| | | | | | | 
}01i131+{7 iG l!oa14ae%$%wwtszs «Ee i 
| | | | | i, ¢ | 
i100018 fH}|] o |x + | 
| | | | | | | 
f!lool1.lfg9 f!Id} er F|TY > | 
| | | | | | | 
!lO1OJA igs!a4sa2zf]<« | 
| | | | | | | 
f1011{B 1K | om | Cl —» | 
| | | | | | | 
eee tre oe a ae 
|l1lo1lt{opD IMi + TJ 1 4 | 
| | | | | | | 
flLIlLOTJE iIn{] 2 | *] 8 f 
| | | | | | 
|} l1illilitdfe 1o!}|] Tr fJ- | | 


5.3.2.4 Status and Option Bytes 


The Models 1200 and 1250/1251 allow the user to read the status 
byte and two option bytes. The status byte is shown in Figure 
5-3. The option bytes for the 1200 are shown in Figures 5-4 and 
5-5. The option bytes’ returned from the Models 1250/1251 are 
always null. 
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Figure 5-3 Status Byte Format 


0-Parity bit (set accordingly) 
1-Overrun=1 

2-Parity error=1l 

3-Printer error=l 

4-Printer busy=1l 

5~Keyboard locked=1 

6-Command error=1 
7-Background busy=1] 


047-3 
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Figure 5-4 Option Byte 1 Format 


O-Parity bit (set accordingly) 
l-Send page terminator, ETX=0, EOT=1 
2-CR line terminator enabled=l 
3-Uppercase only (U/C)=1 

4-AUTO LF enabled=1l 

5-Scroll enable=1 

6-Full/partial screen, full=1 
7-Conversational mode=1 
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Figure 5-5 Option Byte 2 Format 


O-Parity bit (set accordingly) 
1-Transmission mode (nonconversational) 
2-Send immediate all1=00 
Send immediate unprotected=01 
Send immediate modified=10 
Request to send=11l 
3-Parity option-space=00 
4-Mark=01, even=10, odd=11 
5-Null suppress all=l 
6-Send line terminator enable=l 
7-Send line terminator EOT=1, ETX=0 


5.3.2.5 Function Keys and Attention Identifier (AID) Characters 


As an option, the Model 1200 offers 16 user-defined function 
control keys. The Models 1250/1251 offer 12 user-defined keys. 
The number of control codes generated can be expanded to 32 and 
24, respectively, by depressing shift. These keys generate a 
multicode sequence followed by an AID character which is returned 
to the user buffer following an RQS function. Table 5-6 lists 
the function control keys and their associated AID characters for 
the Model 1200. Only keys 1-12 apply to the Models 1250/1251. 


The three send functions listed in Table 5-5 are available on 
three separate keys on the Model 1200 keyboard. The Models 
1250/1251 have one SEND key which can be designated as Send Line, 
Send Message, or Send Page. 


TABLE 5-5 ATTENTION IDENTIFIER (AID) CHARACTERS 


FUNCTION | AID CHARACTERS TRANSMITTED (HEX) | 


| 

| CONTROL 3 |qnnn enero renee nner nr nen nnennn--- | 
| KEY | UNSHIFTED | SHIFTED | 
| 1 | A (41) | a (61) | 
| 2 [| B (42) | b (62) | 
| 3 | Cc (43) | c (63) | 
| 4 | D (44) | qd (64) | 
| 5 | E (45) | e (65) | 
| 6 [| F (46) | F (66) | 
| 7 | G (47) | g (67) | 
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TABLE 5-5 ATTENTION IDENTIFIER (AID) CHARACTERS 
(Continued) 


FUNCTION | AID CHARACTERS TRANSMITTED (HEX) | 


| 

|. “CONTROL, “foq--eaecoseeese ee Seen ee eeae | 
| KEY | UNSHIFTED | SHIFTED | 
| 8 | H (48) | h (68) | 
| 9 | I (49) | i (69) | 
| 10 | J (4A) | 4 (6A) | 
| ll | K (4B) | k (6B) | 
| 12 | L (4C) | 1 (6C) | 
13 | M (4D) | m (6D) | 
| 14 | N (4E) | n (6E) | 
| 15 | O (4F) | o (6F) | 
| 16 | P (50) | p (70) | 
| SEND PAGE | 1 (31) 1 (31) | 
| | | 
| SEND LINE | 2 (32) 2 (32) | 
| | 

| SEND MSG | 3 (33) 3 (33) | 


5.3.3 Modes of Operation 


5.3.3.1 Conversational Mode 


Conversational mode enables the Model 1200 and 1250/1251 VDUs_ to 
transmit and receive data on a character-by-character basis. 
Conversational mode supports read ASCII and write ASCII. 


In conversational mode, the terminal manager provides the same 
logical capability as the TTY/VDU Terminal Manager. 


During read ASCII all data is read until the buffer is full or a 
Carriage return (CR) is found, whichever occurs first. When the 
read terminates, a CR and an LF sequence are sent to the 
terminal. When the character # is entered at the keyboard, the 
current line is ignored. When a backspace character is entered 
at the keyboard, the last character entered is ignored. 


During write ASCII, data is output to the terminal until the 
buffer is empty or a CR is’ found. An LF is automatically 
appended to the detected CR. If no CR is found, an LF CR 
sequence is output to the terminal. 
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5.3.3.2 Image Mode 


When operating in image mode, the Models 1200/1250/1251 terminal 
Managers perform no special character recognition. Data is read 
Or written until the buffer is empty. User tasks (u-task) must 
ensure that the I/O device is under control. To perform an image 
I/O, the SVC 1 function code must have the standard/extended 
options bit set and the extended option fullword format bit 
reset. 


5.3.3.3 Editing Mode 


The editing mode allows the applications programmer to use_ the 
editing capabilities of the Model 1200 and Models 1250/1251 vbDUs. 
In the editing mode, the terminal can function as follows: 


1. The application program outputs to the screen providing a 
fill-in-the-blanks form or data to be edited. 


2. The terminal operator enters data to the terminal while the 
terminal is in local mode and indicates screen-update 
completion by depressing a send or function key. 


3. The CPU receives screen data in a single buffered read. 


Execution of data transmission from the terminal varies depending 
on whether the read is performed in read-immediate mode or _ send 
immediate mode, and on which of the three types of read formats 
(read all, read modified, or read unprotected) is requested. In 
addition, certain special output functions (clear screen, insert 
tabs, move cursor) permit modification of the screen image; 
certain special input functions (read cursor position, read 
status) permit determination of current screen. state. The 
concepts behind these functions are detailed in the following 
section. 


5.3.3.4 Concept of Request-to-Send (RQS) and Immediate 

In immediate mode, data is entered from the keyboard and_ stored 
in terminal memory until the operator depresses a send key. The 
stored data is then transmitted to the host CPU. This mode is 
subdivided into three programmable transmission modes: 

e Send immediate all 

e Send unprotected 


e Send modified 
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These modes permit, respectively, transmission of all data in 
terminal memory, only data in unprotected fields, or only data in 
fields modified by the operator. The operator, in turn, can 
select transmission of a single line, a message starting at _ the 
termination of the last message, or an entire page. 


The RQS mode allows the system designer to fully optimize the 
allocation of host CPU memory. As in immediate mode, no data is 
transmitted while the operator is editing a page to be entered. 
However, when a send key is depressed, the terminal transmits a 
RQS sequence only. This sequence informs the program of which 
send key was depressed; e.g., send line, send message, or any of 
the 16 special function keys. The program then identifies the 
depressed key, allocates the necessary buffer storage, and issues 
the required read multicode sequence to initiate transmission. 
The RQS mode permits all of the preceding at the discretion of 
the host CPU. In addition, the programmer can use a 
send-key-override command to permit the program to select’ the 
correct send mode if the operator's choice of keys is 
unacceptable. | 


5.3.3.5 Types of Data Read Formats 


Four types of data read formats are possible: Read All, Read All 
With Attribute Character Truncated, Read Modified, and Read 
Unprotected. The description of each of these data read formats 
follows: 


1. Read All. Based on the setting of the full/partial screen 
selector, data is transferred starting from home or the 
current cursor position. If the null-suppress-all-option is 
enabled, nulls are suppressed, and the end of a line is 
indicated by transmission of a CR character (X'0OD'). The 
character LF (X'0A') is transmitted following a CR if AUTO/LF 
is enabled. There is no specific format for the data read in 
the buffer. All data displayed on the VDU is filled into the 
user program buffer. The data format is illustrated in 
Figure 5-6. 
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Byte 


Data 


Figure 5-6 Read All with Format Screen 


Read All with Attribute Character Truncated. The terminal 
manager throws away the ESC ! (X'1B',X'21') received and 
sends the following character (by setting the parity bit) as 
an attribute character. There is no specific format for the 
data in the user buffer. All characters except ESC ! are 
sent into the user buffer. The data format is illustrated in 
Figure 5-7. 
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Byte 


OE CE Gene GE ET OEE Gee Gow Sm OST EN GE GET om? GT Ge Om OE oe om 


Byte 


ETX 


Figure 5-7 Read All with Attribute Character Truncated 


Read Unprotected. If the screen is unformatted; (i.e., 
contains no fields) this operation has the same effect as 
read/send all. If the screen is formatted, only unprotected 
fields are transmitted; nulls are suppressed. A field 
containing all nulls is indicated by a single group separator 
(GS) on the Model 1200 or a single Formatted-Send Modified, 
Send Unprotected-Field Terminator on the Models 1250/1251. 
The data formats are illustrated in Figure 5-8 and 5-9. 
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Field 1 


| | Field 2 
GS | (All Nulls) 


Field 3 


om wee oe we Ue On) GP Gee ey os om Se im ee ek att wis Ee ee ee 


Figure 5-8 Read Unprotected Format 
(Model 1200 VDU) 
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2096 SO Cee oe a re ee 


| Formatted Send Modified, | 
| Send Unprotected Field Terminator | 


Formatted Send Modified, | 
{| Send Unprotected Field Terminator | 
| 


2 a awe ae OD Oe SF Ge ET Se GE GT Oe OM GET Gw Gar Gen Gn GH Gy Gm GY Gre OFs GE OF ET ee OE ON OT Ot Ons On 


| Formatted Send Modified, | 
| Send Unprotected Field Terminator | 
| 


BE ‘ L 
po Field t—~—tS I 
| N | 
| Data | 


| Formatted Send Modified, | 
| Unprotected Page Terminator | 


Figure 5-9 Read Unprotected Format 
(Models 1250/1251 VDUs) 


Execution of send line with a formatted screen transmits only 
the first field of the current cursor line following the 
current cursor position. 
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Read Modified. This operation is legal only on a _ formatted 
screen. Read modified transmits only those fields for which 
the modified data tag is set in the field attribute 
character. A modified data tag is set when data is entered 
in a non-light pen field or if the designator character of a 
light pen field has been altered by light pen detection. 
Transmission starts with an SOH, followed by a 2-character 
cursor address sequence, and then the modified fields. Each 
field is preceded by a GS character and the buffer address of 
the first data character in the field for the Model 1200. 
For the Models 1250/1251, the Formatted-Send Modified, Send 
Unprotected-Field Terminator preceeds each field. Nulls are 
suppressed. Model 1200 terminates transmission with an ETX 
character; Models 1250/1251 use the Send Modified, Send 
Unprotected Page Terminator. These formats are illustrated 
in Figures 5-10 and 5-1ll where it is assumed that fields 1 
and have been modified, and field 2 has not. Figure 5-11 
also assumes that there are no light-pen fields. Light pen 
fields transmit only the address of the field rather than the 
address and the data. 


i 
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| 
Cursor | 
|I--- Address == | 

| 


| 
| 
| Field l | 
|--- Address ae 


| Field 3 


Heading 


Field 1 


Field 3 


Figure 5-10 Read Modified Format 
(Model 1200 VDU) 


2698 


| Formatted Send Modified, | 
Send Unprotected Field Terminator | 


| Field 1 | 


Formatted Send Modified, | 
Send Unprotected Field Terminator | 


l Field 3 | 


| Formatted Send Modified, 
| Send Unprotected Field Terminator | 


| Send Modified, Send Unprotected | 
| Page Terminator | 


Figure 5-11 Read Modified Format 
(Models 1250/1251 VDUs) 


5.3.3.6 Types of Data Write Formats 


Two types of edit data write formats are provided: edit write 
and write edit with attribute character generated. 


@e Edit Write. The terminal manager sets the Models 1200 or 
1250/1251 in normal mode and disables echoplex. The data in 
the user buffer is sent to the VDU. 


e Write Edit with Attribute Character Generated (WAG). When the 
terminal manager receives a character with parity bit set, it 
generates an ESC ! multicode sequence to set the attribute 
character. The character received is considered as an 
attribute character to be sent to the VDU. 
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5.3.3.7 Cursor Addressing and Random Addressing 


The terminal manager enables user programs to read cursor address 
(line 00-23/column 00-79), to home cursor, and to set cursor 
positions provided as line/column in the user buffer. 


The terminal manager also handles random I/O by setting the 
cursor position first (for read case) or the VDU display buffer 
(for write case) before issuing I/O. The line/column is provided 
in the random field (first two bytes) of the SVC 1 parameter 
block. 


The user can also imbed the control sequence in the data to be 
sent to the terminal to achieve cursor addressing and random 
address. See Table 5-6 for multicode sequence. The line/column 


format of the cursor or display buffer in the embedded data is 
(xx,xx). Refer to Table 4-4. 


5.3.3.8 Horizontal Tabulation 


Figure 5-12 provides 80 bytes for the user task to _ specify 
tab-stop location. Each byte contains a hexadecimal tab-stop 
position (0-4F) corresponding to the column (1-80) of the VDU 
which is being specified as a tab-stop location. Each byte is 
sequentially scanned until an FF is encountered, which ends’ the 
setting of tab stops. Otherwise, since the screen has only 80 
columns, 80 is the maximum number to scan. 


2899 


DEC 
| 
0 | HT1 | lst tab stop 
aca | 
1 | HT2 | 2nd tab stop 


| ° | 
= eo OF an om a 


79 | HT80 | 80th tab stop 


Figure 5-12 User Buffer Format Table for Horizontal Tabs 


48-047 FOO RO] 5-31 


5.3.3.9 Printer Options 


The character following multicode is an ASCII digit from 1 to 5 
(X'31' to X'35') that determines the operation of the auxiliary 
serial interface, if enabled. On all printouts, the attribute 
characters, line characters, and fields specified as nondisplay 
are printed as spaces. 


@ No printout. The printout currently in progress is allowed to 
finish, and then printing stops. 


@e Print screen from home. The entire screen is printed, up to 
the end of the screen. 


e Print screen from cursor. The screen is printed from the 
current cursor position to the end of the screen. 


e Simulprint (FF control). On receipt of a form-feed character, 
the contents of the screen are printed. If 
read-status-when-ready is in effect, a status byte is 
transmitted when printing is complete. The normal effect of 
the form feed (clear unprotected and home cursor) takes place 
until printing is complete. 


e Simulprint (continuous). In this mode, characters are 
simultaneously printed and displayed as they are received from 
the line. If the printer is running too slowly for the line, 
it transmits a DC4 control character to request that the host 
pause transmission. A DC2 control character is transmitted to 
indicate that the host can resume transmission. 


5.3.4 Sysgen and Environment 

Models 1200/1250/1251 terminal managers support is obtained by 
specifying Model 1200 or Models 1250/1251 at _ sysgen. The 
terminal is configured just as any local device such as a line 
printer or card reader. 

The only restriction on the required order of modules in the 
library is that the DCBs for all devices supported by a 
particular driver or terminal manager must precede the driver or 
terminal manager. 

The system software required to support the terminal manager 
includes: 

@ O0OS/32 RO6 and higher 


e System support module 


e Asynchronous line driver 
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5.3.4.1 Special Parity Requirement 


The terminal manager uses even parity to output all data and 
control sequences to the Model 1200 or Models 1250/1251 vDUs. 
The terminal manager also expects all input data and control 
sequences received from the terminal to have even parity. These 
procedures require that the switch on the Model 1200 be set in 
the even-parity position or the parity be dynamically defined for 


the Models 1250/1251. Failure to do so results in I/O parity 
errors. 


5.3.4.2 Extended Device Code Specification 


The method of system generation used for the Model 1200 uses’ the 
default option index (bits 12 to 15 of the extended device code 
halfword). The format of the extended device code halfword is 
shown in Figure 5-13. The extended device code is initialized at 
sysgen time by using CUP/32. Consult the OS/32 System Planning 
and Configuration Guide for operation of this program. 


Devices other than the Models 1200 and 1250/1251 VDUs that can be 
used with this terminal manager require the master bit (bit 0) of 
the extended device code to be set in the configuration utility 


program input deck. Setting this bit directs the terminal 
Manager not to send the ESC G sequence to the terminal on 
conversational calls. 


When bit 0 of the device code halfword is not set, an I/O request 
cannot be halted while certain 2-character control sequences are 
being output, such as Enter Conversation or Edit Mode. If the 
Models 1200 or 1250/1251 terminals are set for conversational 
mode during power-up, the Halt I/O feature can be initiated by 
setting bit 0. See the Model 1200 Terminal Installation and 
Programming Manual for power-up and mode-setting procedures. 


2900 

| oO fl 2 3] 4 5 |6 718 9|10 11/12 13 14 set 
|Model | | Line | Line | | Default | 
|Code |Reserved| Status |Protocol|Reserved| Clock | Option | 
| | | Code | Code | |Selection| Index | 


Figure 5-13 OS/32 Basic Data Communications Extended 
Device Code Halfword 
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DECIMAL VALUE HEXADECIMAL 


(MASK ) VALUE 
Model Code 
Terminal is Model 1200 or 0 0000 
Models 1250/1251 
Terminal is not Model 1200 32768 8000 
or Models 1250/1251 
Line Status Code 
Direct connection 0 0000 
Leased line 1024 0400 
Dial-in manual dial 2048 0800 
Line Protocol Code 
Half-duplex 4-wire 0 0000 
Half-duplex 2-wire (Model 768 0300 
1200 only) 
Simplex read (Model 1200 only) 256 0100 
Simplex write (Model 1200 512 0200 
only) 
Clock Selection 
Clock A 0 0000 
Clock B 16 0010 
Clock C 32 0020 
Clock D 48 0030 
Default Option Index Refer to Table 5-7 


5.3.4.3 Default Extended Functions/Options 


If the extended option bit (bit 7) is set in the SVC 1 function 
code, the terminal manager further examines the extended 
functions/options the user provides. Otherwise, a table of 
default-extended functions/options is provided. See Table 5-6. 
The particular entry of this table is selected according to _ the 
encoded value of bits 12-15 of the extended device code 
(DCB.XDCD). 
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TABLE 5-6 DEFAULT EXTENDED OPTIONS 


ne G58 OER Ges EF Gn ORE et Om get amt ee Ow OF an OF OF OF On EF Gm OF Om OF EF Ge C= Ot Em Ons OF Gm OT Ot St BT Ont Ott Ort Ot ew ORT Ome 851 BE Ort EN Ewe te ey Ot eee SET ee OOF ems Ot Ow am ow an om 


| DEFAULT | 
| EXTENDED DEVICE CODE | EXTENDED OPTIONS SELECTED | 
ee cata achat aa aa occ a a a gaa a aa a a ema | 
| OPTION | HEX VALUE | DESCRIPTION | 
| 0 | 0 | Conversational, formatted I/O, un- | 
| | | lock keyboard after I/O | 
| | 
| 1 } 1 | Same as encoded value 0 case, plus | 
| ! | enable upper case only | 
| 
| 2 | 2 Same as encoded value 0 case, plus | 
| | nontermination on CR | 
| | | | 
| 3 | 3 | Conversational, formatted I/O, lock | 
| | | keyboard after I/O | 
| | | 
| 4 | 4 | Same as encoded value 3 case, plus | 
| | | enable upper case only | 
| | | | 
| 5 } 5 | Same as encoded value 3 case, plus | 
| | | nontermination on CR | 
| | | | 
| 6 | 6 | Combination of encoded value l, 2 | 
| 7 | 7 | Combination of encoded value 4, 5 | 
| | | | 
| 8 | 8 | Unused, can be source SYSGENed by | 
| | | user | 
| | | | 
| 9 | 9 | Unused, can be source SYSGENed by | 
| | | user | 
| | | | 
} 10 | A | Unused, can be source SYSGENed by | 
| | | user | 
| | | | 
{| 11 | B | Unused, can be source SYSGENed by | 
| | | user 
| | | | 
} 12 | c |} Unused, can be source SYSGENed by | 
| | | user l 
| | | | 
| 13 | D | Unused, can be source SYSGENed by | 
| | | user | 
| | | 
| 14 | E | Unused, can be source SYSGENed by | 
| | | user | 
| | | | 
} 15 | F | Unused, can be source SYSGENed by | 
| | | 
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5.3.4.4 Terminal Switch and Strap Settings 


It is imperative that certain Model 1200 strap and switch 
settings be in a specific position, while others can be set in 
various positions according to system needs. These settings are 
dynamically defined for the Models 1250/1251. A set of 
required/optional terminal switch settings, strap settings, and 
dynamic definitions follows: 


@e Multicode character selection "ESC" - Required 


e Send line terminator "ETX" - Required 


@e Send page or send message 
terminator 


"ETX" - Required 


@ Send line terminator enable, 
ETX follows CR at end of 
send Line (unformatted) - Required 


e Strap to enable transmission of 
CR at end of every line in un- 
formatted send page or send 
message - Optional 


@e Disable blinking block cursor - Optional 


e Parity selection - must be in even 
position - Required 


5.4 INTERNAL TERMINAL MANAGER DESIGN 


The Models 1200/1250/1251 terminal manager enables user programs 
to communicate with the VDU via SVC 1 supervisor calls (with 
extended functions/options). The Models 1200/1250/1251 terminal 
managers support read, write, wait, proceed, unconditional 
proceed, image I/0, random addressing, and user-extended 


functions/options. Four operational modes of the Models 
1200/1250/1251 terminal managers are supported: conversational 
mode, image mode, data-dependent editing mode, and 


data-independent editing mode. 


5.4.1 Relationship to Operating System and Asynchronous 
Line Driver 


The device-independent support of the Model 1200 and Models 
1250/1251 vVDUs in a point-to-point environment is provided by the 
Models 1200/1250/1251 terminal managers. The terminal manager 
calls the asynchronous driver to perform user-desired I/O. 
However, a user SVC 1 enters the terminal manager only via the 
SVC 1 executor of the OS. Refer to Figure 5-14 for the 
relationships to OS and the Asynchronous Line Driver. 
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| SVC 1 | 


| 1st Level | 
| Interrupt | 
| Handler | 


| SVC l | 


| Asynchronous | 
| I/O 
| Handler | 


| Point-to-Point | | Svc l | 
| Service |------ >| Executor | 
| Handler b 49° Sesser see sees 


{| Asynchronous | 
| Terminal | 
| Manager | 
| (Kernel) | 


| Asynchronous | | 
| Line | <----->| 2-Line |<--| | 
| Driver | | 


foe) 
I 
Le 
}- 
= 
o 
“0—-— 


Figure 5-14 Models 1200/1250/1251 Terminal Manager/Asynchronous 
Line Driver Relationship (Point-to-Point) 
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The terminal manager is initially entered from the SVC 1 executor 
which validates the SVC 1 function call, sets up the OS 
environment, and sets up the OS/32 Basic Data Communications 
environment. The asynchronous line driver provides the interface 
between the terminal manager and an asynchronous communications 
adapter connected to the VDU. Figure 5-15 lists the DCB Fields 
For the Model 1200 and Models 1250/1251 VDUs. 


2902 

| (F8) | (F9) | (FB) | 
| BRK | Reserved | RECS | 
pn a a a a aaa al a rao ana a | 
(FC) | (FF) | 
SPCR | SPCW | 

| | | 
| (100) | 
| XLT l 
| | 
aan at a ai a a laa he ale | 
| (104) | (107) | 
: Reserved | PDCT | 
sce gence se cau ca aaa oa | 
| (108) | 
| SUBR | 
| | 
es a ee ee aaa Sees e eae ee | 
| (10C) | 
| WORK 
| | 
[=SA eee Soe Sea eee eS eee hee See eee e ee ea ees Hees | 
{ (110) | 
| FDCT 
| | 
ec ea aa al aa aa | 
| (114) | 
| LDCT | 
| | 
eel a a a cl a | 
| (118) | 
| FNQH | 
| | 
el a a a ae a alg ae | 
{ (11C) | 
| FNQT | 


Figure 5-15 Device Control Block (DCB) Fields for Models 
1200 and 1250/1251 vbDUs 
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| (120) 
| TMLH | 
| | 
Fanaa tenant aaa ae haa aaa | 
| (124) | 
| BFPT | 
| | 
 Kaeteteaieshesenentenhentestenteatonentententeateentenhashenteatenhaeieatenrenental teenth eile aera | 
| (128) | 
| CDAT l 
| | 
a a ac a aaa a aca aa cea | 
| (12C) | 
| CMDM 
| | 
eg ee aa al laa a alae a lal al ala a lacey 
| (134) | 
| EXIT 
| | 
 heteneetesnahatathnetenatahatatanatabatatatatatatatenatatatetetttahetetatetatatatatataetetataletatatan aaa | 
| (138) | 
LINK | 

| | 

(13C) 

| INDX | 
| | 
 Kecententesbehetestereniasintatnteienetatatatatatatatatatatelatetatatebatettatntataatatatatetabataatateateattatahae | 
| (140) | 
| SVFR | 
| | 
 lecantenhaieehetatesteninetatatenahehatanatelatahatatatateteletetaatatetatatatedlatetatatateaaaiataeeatanaene | 
| (144) | (146) | 
PTMV Reserved | 


Figure 5-15 Device Control Block (DCB) Fields for Models 
1200 and 1250/1251 vVDUs (Continued) 


These fields must follow the BASIC DCB and the communications 
subsystem DCB fields described in the 0S/32 Basic Data 
Communications Reference Manual. 


Following is a description of the Models 1200/1250/1251 related 
DCB fields: 


DCB. BRK Output command for break 
DCB. RECS Transparent record size 
DCB.SPCR Special character mask for read 
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5.4.2 


DCB. SPCW 
DCB.XLT 

DCB. PDCT 
DCB.SUBR 
DCB.WORK 
DCB.FDCT 
DCB.LDCT 
DCB. FNQH 
DCB.FNQT 
DCB. TMLH 
DCB.BFPT 
DCB.CDAT 
DCB.CMDM 
DCB.EXIT 
DCB. LINK 
DCB. INDX 
DCB.SVFR 
DCB. PTMV 


Special character mask for write 

Translate table address 

Count of trailing (pad) characters 
Subroutine return address save area 

Working storage used by terminal manager 
First device control table 

Last device control table 

First device control table in function queue 
Last device control table in function queue 
Logical timerchain head PTR 

Pointer to buffer in system space 

Current date 

Bit mask of invalid extended function 
Return address initialized 

Link address initialized 

Extended option index initialized 

Return address for MSVP WTB/DO.SVFI 

Timer value for poll cycle 


Internal Structure 


Following is 


components 


of the Models 1200/1250/1251 terminal managers. 


functional description of the three major 


See 


the flow diagram, Figure 5-16. 


48-047 FOO RO1 


| User | | svc l | 
|} svc 1 |— >I! Executor | 
| 
~------------y-- Entry for SVC 1 EXECUTOR 
| | Initialization | 
| ---n ene nnn | <Set Up Proper OS/32 Basic Data 
| Error | Function Code | | Communications Environments 
| Interpretation | (Decode and Validate Request 
| J 
| : | Conversational I/O 
Preparation | Image I/O 
| For I/O | Editing I/O and Control Sequences 
Control | Validate Request 


| ---------------- | Build SVC 15 Data and Command Chain 
Enter SVC 15 | Enter SVC 15 


Termination Entry From SVC 15 
Error Checking 


| Final Return Status 
Clean Up Set Up Proper Data Communications 
| and Environment 
, | 
| a 
‘Done > 
| - 


Figure 5-16 Kernel Terminal Manager Flow Diagram 


5.4.2.1 Initialization and Function Code Interpretation 


This component provides the entry for SVC 1 execution, sets up 
data communications environments, decodes the SVC 1 function code 
with extended functions/options, sets the default extensions as 
required, validates extended functions/options, and jumps to 
various routines to handle various I/O preparations. 
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5.4.2.2 Preparation for I/O, Control, and Enter SVC 15 


From the initialization decoding process, various routines are 
provided in this component. Validation of extended 
functions/options in the individual case is also performed. 
After all preparations and the SVC 15 data/command chain are 
built, actual entering of SVC 15 is initiated. This component 
also provides control sequences. 


5.4.2.3 Final Clean Up 

This component provides termination return of SVC 15, handles 
errors, returns status to the user, and sets up or restores data 
communications control. 

5.5 TYPICAL PROBLEM CHECKLIST 

The user should exercise caution in using the Model 1200 and the 
Models 1250/1251 point-to-point VDUs. Users can run stand-alone 


diagnostics or call customer service if the following error 
checklist entries are not responded to in the correct manner: 


1. Model 1200 switch is not in even parity position or _ even 
parity is not defined for Models 1250/1251. 
2. Read immediate does not follow request to send. 


3. Failure to provide random address (X,Y coordinates) in user 
SVC 1 parameter block for random read/write 


4. Failure to provide tab-stop positions in the user buffer 


5. Failure to provide cursor position (00-17, for line #, 0O0-4F 
for column #) for setting cursor position in the user buffer 


6. Failure to supply ae buffer. A valid buffer address is 
required for all calls. 


7. Incorrect PALS/PASLA cable 

8. Terminal is not online. 

9. Incorrect speed match between terminal switch settings, 
PALS/PASLA clock strapping and CUP OS/32 Basic Data 


Communications extended device code 


10. Terminal switch was set without performing either a 
powerup/down or clear all. 


11. Auto line feed, new line, or scroll enable switch definitions 
are inconsistent with data output. 
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12. Failure to provide null characters following certain embedded 
escape sequences 


13. Failure to activate CPU clock prior to telephone answer 
sequences 


14. Pin 25 is not cut on PALS/PASLA cable. 


15. Incorrect Bell modem options were specified. 


5.6 MULTIDROP FEATURE 


The terminal manager supports the mutlidrop feature only on the 
Models 1250/1251 vDUs. This feature allows multiple Models 
1250/1251 VDUs to share a single communications line by using the 
poll and select technique. Since only one terminal can transmit 
data at any one time in a multidrop environment, terminal 
response is delayed longer than in a point-to-point environment. 


Multidrop support includes: 


@ dynamic generation of necessary data structures, 


@e transparent access to multidrop devices at the device 
independent I/O level, 


@ support of all multidrop functions limited to block mode, and 


@® remote connections support via Bell* 212A, 10303, or 113D 
series modems. 


5.7 LIGHT PEN 


The terminal manager also supports the use of the light pen on 
the Models 1250/1251. The light pen is a light-sensitive pen 
connected to the terminal that detects variations in light 
emitted by the data characters on the screen. Refer to the 
Models 1250/1251 VDUs User's Manual for a detailed description of 
the light pen feature. 


5.8 ENCODED ERROR MESSAGES 
Encoded messages are displayed as the result of an error 


occurring when a READ or WRITE macro is issued. Table 5-7 lists 
the messages that can be generated. 
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TABLE 5-7 ENCODED ERRORS AND DEFINITIONS FOR MODELS 


1200/1250/1251 TERMINAL MANAGERS 


STATUS CODE 


(HEX) | MEANING 
0000 | No errors 
| 
8402 | Line delete caused termination during read 
8203 | Break detected during write 
8204 | Break detected during read 
8205 | Terminated by data error (see parity bits) 
8208 | Framing or stop-bit error 
8409 Reverse channel error 
200A | Lost carrier on read 
200B | Lost clear-to-send on write 
200C | Data set not ready 
840D | Device unavailable; adapter not present 
200E {| Character overflow 
840F | Ring status detected during data transfer 
| 
8410 | Busy and/or done bits in chained buffers 
| bad; may indicate priority to low 
| 
8411 | Number of commands executed greater than 
255 
| 
8412 | Task queve full, invalid, or nonexistent. 
| | 
8413 | Buffer-management-routine error; may indi- 
| cate priority too low 
| 
8282 | Timeout 
| 
8281 | Halt I/O request aborted I/0 
| 
8481 | Illegal command or modifier 
8419 | Memory fault in referencing data 
| 
841A | Memory fault in referencing buffer 
811B | Lu illegal 
| 
821C | Illogical device status 
| 
AO1D | Power failure 
| 
841E | Illegal software condition 
841F | Illegal translation table 
| 
8225 | Timeout during connect sequence 
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TABLE 5-7 ENCODED ERRORS AND DEFINITIONS FOR MODELS 


1200/1250/1251 TERMINAL MANAGERS 


(Continued) 


4 
a 
Fy 
Cc 
tn 
Q 
© 
oO 
rea 


(HEX) 


DMA I/O System (DIOS) hardware error 


Attempted a conversational I/O to a polled 
terminal | 


No response from terminal to poll 


* Applies to Models 1250/1251 only 


The first byte of each status code listed in Table 5-1 refers to 
the device independent status of the error. These codes are 


defined as follows: 


CODE 


CO 


AC 


20 


90 
88 
84 
82 
81 
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DEFINITION 


Illegal function 


Device unavailable, signoff user. If switched 
line, reissue call. 


Device unavailable or parity error sent to 
recovery routine 


End of medium 

End of file 

Unrecoverable error; report to operator 

Parity or recoverable error; reissue the call. 


Illegal or unassigned lu 


APPENDIX A 
DRIVER COMMAND WORD (DCW) FORMAT 


047-9 


MODIFIER/ NO. 
COMMAND DATA DATA FIELD 
COMMAND BYTE HEX VALIDCOMMANDHALFWORDS FIELDS SPECIFIES 
NULL 
NOP xxoo [cc|cT| x | x | Xxxxjoooojooof. = 1 Any valid 
address 
WAIT xxos [CC[CT] x [0 [XxXx]00001 [000] 1 Halfword 
XFER XX10 [CC] CT] xX | X | Xxxx]00010 [000] l Halfword 
CXFER Xx18 |CC]CT] X | X |] XXXx]00011]000} 2 2 Halfwords 
Valid Address 
CONTROL 3 
"EXAMINE xxor [ocler] x] To] xxxx]ooos0]oo] «1 Byte 
RING WAIT -Xx09 {CC }CT{ X | TO] XXXxX{00001} 001] None 
ANSWER xxl! Lec} ct] x _[ TO] xxxx]00010] 001] None 
DISCONNECT XxX19 ~CC|CT{ X | TO] Xxxx{00011{001] None 
READ 
READ BUFFER Xx02 [CC {CT | BT| TO] XXxx]00000]010 lor2 Buffers 
READI XXOA [CC[CT[BT] TO[XXXX]OOOOI[OTO) «1 Byte 
READ?2 xx12_ [cc] cr [BT] TOT xxxxJoooi0fo10] = 2 ~—sBytes 
PREPARE 
PREP xxo3 [cc {ct | x-] TO| Xxxxjooooojolt} = Byte 
WRITE 
WRITE BUFFER Xx04 [CC |CT | BT{ TO {| XXXxX|00000] 100 lor2 Buffers 
WRITE1 xxoc [CC] CT |BT| TO] XxXxx[0000!} 100} Byte 
WRITE2 Xx14 [CC [CT [BT] TO|XXXX{00010/100} 2 Bytes 
HOLD | | 
BREAK xxos [CC [CT] X} TO] XXXxj00000]101f = =1 = Halfword 
MODE 
TOUT xx06 [CC] CT ]x]X{xxxx{00000[ 110 | | Fullword 
CMD2 XxoE [CC] CT ]x}x[xxxx]00001 | 110 ! Byte 
RCMD XXlo {CC { CT [X|[X{XXXxX 00010] 110) Byte 
WCMD XXIE LCC] CT JX [X[XXXxX 00011] 110 | | Byte 
RDIS XX20 LCC] CT JX}X}XXXX [00100] 110 | 1 Byte 
wDIs XX2E [CC] CT Jx[X|XxXxX]00101] 110 | 1 Byte 
DISC xx3o [ECT CR ]XKRXXX OO OTT) 1 Byte 
TRNSL XX46 1 Byte 


SPEC CHAR xxae [CCT CE XK RXxx roo}, 


_ 


Fullword 
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2520 


La 
™N 


ig 
let 
cr 
wa 


APPENDIX B 
STANDARD ASCII CODE 


COMMUNICATION PRINTABLE 
me CODES CHARACTERS 


Fara ye Oe Ge eek 

fofofojo| o { nuc| oe | sp [| o | e@ | P| 

FICCI ST 7 Ot GT 

CRE Ce ek Se 

eats ape ee 
EOT } DC4 | T 

nities erat: a se 

fol aol ioe Cave 

oft tt 7 ben perm] 17 16 | 

lols) ol eee ca 

Vfofoji{ 9 | HT | eM | 

vette 10 [ oe Pau 

HC Ec 

ENC) CT a eros 

TO ers ee ee 

ntitr ofits T ae 

iph poste [us 


Standard 96-character ASCII Set 


64-character ASCII Set displayed when U/C Switch is enabled. 
(DEL is as legal character in this mode and is displayed as 
a quadrangle with alternate dots.) 


In transparent mode, all control codes are displayed as 
Shown in sample display. In normal display mode, control 
Characters are not displayed. 
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INDEX 


chained/queued buffer link procedures, 


A | Conversational VDU/TTY 
| sysgen device statement 
Asynchronous line driver 3-1 | 
3-29 | D 
buffers and traps 3-18 
commands supported Qn 7 | Data read formats, Models 
default values 3-18 | 1200/1250/1251 VDUs 
special character processing 3-16 | read all 
SVC 15 access 371 read all with attribute 
terminal manager access 3-1 : character truncated 
read modified 
| read unprotected 
B | Data set adapters 
{ Data write formats, Models 
ae nae ee 5 1200/1250/1251 VDUs 
~line mu plexor - edit write 
PALS 2-3 | write edit with attribute 
PASLA 2-3 | character generated (WAG) 
Se multiplexor 2-4 | Default values 
Buffer types 3-20 for mode commands 
chained 3-20 | Device dependent access 
3-22 | Device independent access 
ana ee | Direct buffers 
indirect = format 
3-21 | DMA I/0 subsystem (DIOS) 
queued 3-20 | 
3-24 | 
traps 3-27 | E F 
Buffers and traps 3-18 | 
buffer management 3-19 ELIMINATE command 
buffer types 3-20 | Encoded error messages, Models 
data field chain 3-18 | 1200/1250/1251 VDUs 
DCW chain 3-18 | Extended device codes 
direct buffers 3-20 | 
indirect buffers 3-21 l 
G 
| 
Cc | GENERATE command 
| GENERATE macro 
Cables 2-6 
Carousel 300 terminal 4-4 | 
character structure 4-10 | H 
modem connection 4-10 | 
system characteristics 4-10 | Hard fi P 
Chained buffers 3-22 ardware configuration 
word flag byte 3-23 | cables 
chained/queued format 3-23 | data set adapters 
Commands, asynchronous line | DIOS 
driver, supported by 3-7 Spectron MIS-3400 modem 
Commands, Models 1200/1280/1251 | Splitter 
editing VDU terminal manager, | strapping options 
ELIMINATE 5-5 terminals 
GENERATE 5-2 | 
Common terminal logical record 
lengths 2-10 | Igk 
Configuration procedures, | 
hardware 2-1 | Indirect buffers 
software 2-7 { format 
| 
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mim 
NO dD 


Light pen 


HNO 


Macros, Models 1200/1250/1251 
editing VDU terminal manager, 
GENERATE 
XFMPCB 
Model 1100 VDU 
communications interfac 
features 
factory options 
internal strapping, 
switching 
local control keys 
modes 
multicode sequences 
operation 
operational characterstics 
operator control functicns 
single character ASCII 
functions 
Model 1100 VDU, operational 
modes, 
FLX 
HDX 
normal 
transparent 
Modems 
options 
Module specification 
Model 1200 editing VDU 
sysgen device statement 


Models 1250/1251 point-to-point 


V0DUs 
sysgen. device statement 
Models 1250/1251 terminal 
configuration 
downline load 
user configuration 
Models 1200/1250/1251 editing 
VIU terminal manager 
commands 
cursor addressing 
data read formats 
data write formats 
default extended functions/ 
options 
device assignment 
encoded error messages 
extended device code 
specification 
horizontal tabulation 
internal design 
internal structure 
INITMASY 
light pen 
macros 
Models 1250/1251 terminal 
configuration 
multidrop feature 
printer options 
random addressing 
required software 
special character format 
special parity requirement 
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sysgen and environment 
terminal features 
terminal switch and strap 
settings 
use of 
Models 1200/1250/1251 editing 
VDU terminal manager, 
internal design 
DCB fields 
internal structure 
relationship to operating 
system and asynchronous 
line driver 
Models 1200/1250/1251 editing 
VDU terminal manager, 
internal structure 
clean up 


initialization and function 


code interpretation 
I/O, control, enter SVC 
preparation 
Models 1200/1250/1251 VDUs, 
operational modes, 
conversational 
editing 
image 
immediate 
request to send (RQS) 
Models 1200/1250/1251 VDUs 
terminal features 
AID characters 
attribute characters 
function keys 
line drawing characters 
multicode sequence 
status, option bytes 
Multidrop feature 


P 


Problem checklist, Models 
1200/1250/1251 VDUs 


Q 


Queved buffers 
circular list 


R 


Remote line printer 
sysgen device statement 


Ss 


Sigma 10 terminal 
sysgen device statement 
Software configuration 
procedures, 
common terminal logical 
record lengths 


extended device codes 
module specification 
special asynchronous 
characters 

sysgen 
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Special asynchronous characters 2-11 


Special character processing 
backspace characters 
bit mask 
ending or terminating 

characters 

line delete characters 
miscellaneous characters 
special characters 

Spectron MIS-3400 modem 

splitter 

Strapping options 
CLCM stragpring 
Clocks 
8-line multiplexor baud 

rates 
PALS baud rates 
PASLA baud rates 
2-line multiplexor baud 
rates , 

Supervisor call 15 (SVC 15) 
data field 
driver command options 
driver command word format 
encoded errors and 

definitions 

line driver access 
parameter block 

status halfword 
terminal manager access 
traps 

SVC 15 only, 
asynchronous device 
sysgen device statement 

SVC 15 parameter block 
function code format 

SVC 1, 
extended options 
interface 

SVC 1 extended options 
extended functions 
fullword format 
function modifiers 
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3-16 
3-16 
3-16 


fa ett 
SNHAUYUAAA 


Sysgen device statements 
conversational VDU/TTY 
Model 1200 editing VDU 
Models 1260/1251 point-to- 

point VDUs 
remote line printer 
sigma 10 terminal 
SVC 15 only asynchronous 
device 


TUVW 


Terminal managers, 
Models 1200/1250/1251 
editing VDU 
TTY/VDU 
Terminals, supported by data 
communications subsystem 
Traps 
task trap format 
TSW 
TTY/VDU terminal manager 
Carousel 300 terminal 
data optimization © 
encoded error messages 
Model 1100 VDU 


special-character processing 


supported attributes 
supported functions 
supported terminals 
SVC 1 access 
TTY/VDU terminal manager, 
supported functions 
READ ASCII 
read or write image 
WRITE ASCII 


XYZ 
XFMPCB macro 


cum 
ot 
—_ = 


bite 
~] © ~) 


iopeut tot 
= 0 


FHrrererrreereeEwwwn 
1 
[2NWWeraroaoa fo NNAIN 


' ot 
Ww WwW Ww WwW 
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